WebClient.Credentials Egenskap

Definition

Namnområde:

System.Net

Sammansättning:

System.dll

Hämtar eller anger de nätverksautentiseringsuppgifter som skickas till värden och används för att autentisera begäran.

public:
 property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };

public System.Net.ICredentials Credentials { get; set; }

member this.Credentials : System.Net.ICredentials with get, set

Public Property Credentials As ICredentials

Egenskapsvärde

ICredentials

En ICredentials som innehåller autentiseringsuppgifterna för begäran. Standardvärdet är null.

Exempel

I följande kodexempel används användarens systemautentiseringsuppgifter för att autentisera en begäran.

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 

Kommentarer

Caution

WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.

Egenskapen Credentials innehåller de autentiseringsuppgifter som används för att komma åt en resurs på en värd. I de flesta scenarier på klientsidan bör du använda DefaultCredentials, som är autentiseringsuppgifterna för den inloggade användaren. Det gör du genom att ange egenskapen UseDefaultCredentials till i stället för att true ange den här egenskapen.

Om klassen WebClient används i ett mellannivåprogram, till exempel ett ASP.NET program, tillhör DefaultCredentials kontot som kör ASP-sidan (autentiseringsuppgifterna på serversidan). Vanligtvis anger du den här egenskapen till autentiseringsuppgifterna för klienten för vars räkning begäran görs.

Av säkerhetsskäl lagrar du de autentiseringsuppgifter som du vill inkludera i omdirigeringen i en CredentialCache och tilldelar den till den här egenskapen när du automatiskt följer omdirigeringar. Den här egenskapen anges automatiskt till null vid omdirigering om den innehåller något annat än en CredentialCache. Om du har det här egenskapsvärdet automatiskt inställt null på under dessa villkor förhindras autentiseringsuppgifter från att skickas till ett oavsiktligt mål.

Se även

• NetworkCredential
• CredentialCache
• Credentials