WebClient.Credentials Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

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

ICredentials obsahující přihlašovací údaje pro ověření požadavku. 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 DefaultCredentials, což jsou přihlašovací údaje aktuálně přihlášeného uživatele. Chcete-li to provést, nastavte vlastnost UseDefaultCredentials na true namísto nastavení této vlastnosti.

Pokud se třída WebClient používá v aplikaci střední vrstvy, například v aplikaci 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í, do CredentialCache a přiřaďte je k této vlastnosti. Tato vlastnost se automaticky nastaví na null při přesměrování, pokud obsahuje cokoli kromě CredentialCache. Když se tato hodnota vlastnosti automaticky nastaví na null za 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