NetworkCredential Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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) |