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 utilizzate 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, ovvero 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, appartiene DefaultCredentials all'account che esegue la pagina ASP (credenziali lato server). In genere, è necessario impostare questa proprietà sulle credenziali del client per conto del quale viene effettuata la richiesta.
Per motivi di sicurezza, quando si seguono automaticamente i reindirizzamenti, archiviare le credenziali che si desidera includere nel reindirizzamento in un CredentialCache oggetto e assegnarlo a questa proprietà. Questa proprietà verrà impostata automaticamente su null
al momento del reindirizzamento se contiene elementi tranne un oggetto CredentialCache. Se questo valore della proprietà viene impostato automaticamente su null
in queste condizioni, le credenziali non vengono inviate a una destinazione imprevista.
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