Compartir a través de


NetworkCredential Clase

Definición

Proporciona credenciales para esquemas de autenticación basados en contraseña, como la autenticación básica, implícita, NTLM y Kerberos.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost
public ref class NetworkCredential : System::Net::ICredentials
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
public class NetworkCredential : System.Net.ICredentials
type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost
type NetworkCredential = class
    interface ICredentials
Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost
Public Class NetworkCredential
Implements ICredentials
Herencia
NetworkCredential
Implementaciones

Ejemplos

En el ejemplo de código siguiente se asocia un NetworkCredential objeto a un conjunto de identificadores uniformes de recursos (URI) en un CredentialCache. A continuación, pasa el CredentialCache objeto a un HttpClient objeto , que lo usa para autenticar las solicitudes en un servidor de Internet.

NetworkCredential^ myCred = gcnew NetworkCredential(
   SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain );

CredentialCache^ myCache = gcnew CredentialCache;

myCache->Add( gcnew Uri( "http://www.contoso.com" ), "Basic", myCred );
myCache->Add( gcnew Uri( "http://app.contoso.com" ), "Basic", myCred );

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Credentials = myCache;
HttpClient^ client = gcnew HttpClient(handler);
NetworkCredential myCred = new NetworkCredential(
    SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Credentials = myCache
});
Dim myCred As New NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain)

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com"), "Basic", myCred)
myCache.Add(New Uri("http://app.contoso.com"), "Basic", myCred)
       
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Credentials = myCache
})

Comentarios

La NetworkCredential clase es una clase base que proporciona credenciales en esquemas de autenticación basados en contraseña, como basic, digest, NTLM y Kerberos. Las clases que implementan la ICredentials interfaz, como la CredentialCache clase , devuelven NetworkCredential objetos.

Esta clase no admite métodos de autenticación públicos basados en claves, como la autenticación de cliente de Capa de sockets seguros (SSL).

Constructores

NetworkCredential()

Inicializa una nueva instancia de la clase NetworkCredential.

NetworkCredential(String, SecureString)

Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario y la contraseña especificados.

NetworkCredential(String, SecureString, String)

Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario, la contraseña y el dominio especificados.

NetworkCredential(String, String)

Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario y la contraseña especificados.

NetworkCredential(String, String, String)

Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario, la contraseña y el dominio especificados.

Propiedades

Domain

Obtiene o establece el nombre de equipo o dominio que comprueba las credenciales.

Password

Obtiene o establece la contraseña del nombre de usuario asociada a las credenciales.

SecurePassword

Obtiene o establece la contraseña como una instancia de SecureString.

UserName

Obtiene o establece el nombre de usuario asociado a las credenciales.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetCredential(String, Int32, String)

Devuelve una instancia de la clase NetworkCredential para el host, el puerto y el tipo de autenticación especificados.

GetCredential(Uri, String)

Devuelve una instancia de la clase NetworkCredential para el identificador uniforme de recursos (URI) y el tipo de autenticación especificados.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a