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 odešlou hostiteli a použijí 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í formát 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

Vlastnost Credentials obsahuje přihlašovací údaje pro ověřování 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 UseDefaultCredentials vlastnost na true hodnotu namísto nastavení této vlastnosti.

WebClient Pokud se třída používá v aplikaci střední vrstvy, například v aplikaci ASP.NET, patří do účtu, DefaultCredentials 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 žádost provedena.

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í, a CredentialCache 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. Automatické nastavení této hodnoty vlastnosti za null těchto podmínek zabrání odeslání přihlašovacích údajů do jakéhokoli nezamýšleného cíle.

Viz také

• NetworkCredential
• CredentialCache
• Credentials