WebClient.Credentials Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.WebClient.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
WebClient.cs
Źródło:
WebClient.cs
Źródło:
WebClient.cs

Pobiera lub ustawia poświadczenia sieciowe wysyłane do hosta i używane do uwierzytelniania żądania.

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

Wartość właściwości

ICredentials

Element ICredentials zawierający poświadczenia uwierzytelniania dla żądania. Wartość domyślna to null.

Przykłady

Poniższy przykład kodu używa poświadczeń systemowych użytkownika do uwierzytelniania żądania.

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

Uwagi

Właściwość Credentials zawiera poświadczenia uwierzytelniania używane do uzyskiwania dostępu do zasobu na hoście. W większości scenariuszy po stronie klienta należy użyć DefaultCredentials, które są poświadczeniami aktualnie zalogowanego użytkownika. W tym celu ustaw UseDefaultCredentials właściwość na true wartość zamiast ustawiania tej właściwości.

WebClient Jeśli klasa jest używana w aplikacji warstwy środkowej, takiej jak aplikacja ASP.NET, DefaultCredentials należy do konta, na którym działa strona ASP (poświadczenia po stronie serwera). Zazwyczaj tę właściwość należy ustawić na poświadczenia klienta, w którym imieniu jest wykonywane żądanie.

Ze względów bezpieczeństwa, gdy następuje automatyczne przekierowania, zapisz poświadczenia, które mają zostać uwzględnione w przekierowaniu w CredentialCache obiekcie i przypisz je do tej właściwości. Ta właściwość zostanie automatycznie ustawiona null na wartość po przekierowaniu, jeśli zawiera wszystkie elementy z wyjątkiem CredentialCache. Ustawienie tej wartości właściwości na null wartość w tych warunkach uniemożliwia wysyłanie poświadczeń do niezamierzonego miejsca docelowego.

Dotyczy

Zobacz też