WebClient.Credentials Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta le credenziali di rete inviate all'host e utilizzate per l'autenticazione della richiesta.
public:
property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };
public System.Net.ICredentials? Credentials { get; set; }
public System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Property Credentials As ICredentials
Valore della proprietà
Un oggetto ICredentials contenente le credenziali di autenticazione per la richiesta. Il valore predefinito è null
.
Esempio
Nell'esempio di codice seguente vengono usate le credenziali di sistema dell'utente per autenticare una richiesta.
int main()
{
try
{
WebClient^ client = gcnew WebClient;
client->Credentials = CredentialCache::DefaultCredentials;
array<Byte>^pageData = client->DownloadData( "http://www.contoso.com" );
String^ pageHtml = Encoding::ASCII->GetString( pageData );
Console::WriteLine( pageHtml );
}
catch ( WebException^ webEx )
{
Console::Write( webEx );
}
}
public static void Main()
{
try {
WebClient client = new WebClient();
client.Credentials = CredentialCache.DefaultCredentials;
Byte[] pageData = client.DownloadData("http://www.contoso.com");
string pageHtml = Encoding.ASCII.GetString(pageData);
Console.WriteLine(pageHtml);
} catch (WebException webEx) {
Console.Write(webEx.ToString());
}
}
Public Shared Sub Main()
Try
Dim client As New WebClient()
client.Credentials = CredentialCache.DefaultCredentials
Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
Dim pageHtml As String = Encoding.ASCII.GetString(pageData)
Console.WriteLine(pageHtml)
Catch webEx As WebException
Console.Write(webEx.ToString())
End Try
End Sub
Commenti
La Credentials proprietà contiene le credenziali di autenticazione usate per accedere a una risorsa in un host. Nella maggior parte degli scenari lato client è consigliabile usare DefaultCredentials, che sono le credenziali dell'utente attualmente connesso. A tale scopo, impostare la UseDefaultCredentials proprietà su true
anziché impostare questa proprietà.
Se la WebClient classe viene usata in un'applicazione di livello intermedio, ad esempio un'applicazione ASP.NET, l'appartenenza DefaultCredentials all'account che esegue la pagina ASP (le credenziali lato server). In genere, questa proprietà verrà impostata sulle credenziali del client per conto della richiesta.
Per motivi di sicurezza, quando si seguono automaticamente i reindirizzamenti, archiviare le credenziali da includere nel reindirizzamento in un CredentialCache oggetto e assegnarlo a questa proprietà. Questa proprietà verrà impostata automaticamente su null
dopo il reindirizzamento se contiene qualsiasi elemento, ad eccezione di .CredentialCache Se questo valore della proprietà viene impostato automaticamente su null
in queste condizioni, impedisce l'invio delle credenziali a qualsiasi destinazione non prevista.
Si applica a
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per