WebClient.Credentials Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Zdroj:

WebClient.cs

Získá nebo nastaví síťové přihlašovací údaje, které se odesílají hostiteli a používají se k ověření požadavku.

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

Hodnota vlastnosti

ICredentials

Obsahuje ICredentials ověřovací přihlašovací údaje pro požadavek. Výchozí hodnota je null.

Příklady

Následující příklad kódu používá k ověření požadavku systémové přihlašovací údaje uživatele.

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 

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Vlastnost Credentials obsahuje ověřovací přihlašovací údaje používané pro přístup k prostředku na hostiteli. Ve většině scénářů na straně klienta byste měli použít DefaultCredentialspřihlašovací údaje aktuálně přihlášeného uživatele. Chcete-li to provést, nastavte UseDefaultCredentials vlastnost na true místo nastavení této vlastnosti.

WebClient Pokud se třída používá v aplikaci střední vrstvy, jako je například aplikace ASP.NET, DefaultCredentials patří k účtu, na kterém běží stránka ASP (přihlašovací údaje na straně serveru). Obvykle byste tuto vlastnost nastavili na přihlašovací údaje klienta, jehož jménem je požadavek proveden.

Z bezpečnostních důvodů při automatickém sledování přesměrování uložte přihlašovací údaje, které chcete zahrnout do přesměrování, CredentialCache a přiřaďte je k této vlastnosti. Tato vlastnost se automaticky nastaví null při přesměrování, pokud obsahuje cokoli kromě CredentialCache. Když se tato hodnota vlastnosti automaticky nastaví za null těchto podmínek, zabrání tomu, aby se přihlašovací údaje odesílaly do jakéhokoli nezamýšleného cíle.

Viz také

• NetworkCredential
• CredentialCache
• Credentials