WebClient.Credentials Özellik

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

Özellik Değeri

ICredentials İstek için kimlik doğrulama kimlik bilgilerini içeren. Varsayılan değer: null.

Örnekler

Aşağıdaki kod örneği, isteğin kimliğini doğrulamak için kullanıcının sistem kimlik bilgilerini kullanır.

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 

Açıklamalar

özelliği, Credentials konak üzerindeki bir kaynağa erişmek için kullanılan kimlik doğrulama kimlik bilgilerini içerir. çoğu istemci tarafı senaryosunda, şu anda oturum açmış olan kullanıcının kimlik bilgileri olan öğesini kullanmanız DefaultCredentialsgerekir. Bunu yapmak için, bu özelliği ayarlamak yerine özelliğini olarak true ayarlayınUseDefaultCredentials.

WebClient Sınıf, ASP.NET uygulaması gibi bir orta katman uygulamasında kullanılıyorsa, DefaultCredentials ASP sayfasını (sunucu tarafı kimlik bilgileri) çalıştıran hesaba aittir. Genellikle, bu özelliği isteğin yapıldığı istemcinin kimlik bilgilerine ayarlarsınız.

Güvenlik nedenleriyle, yeniden yönlendirmeleri otomatik olarak takip ederken, yeniden yönlendirmeye eklenmesini istediğiniz kimlik bilgilerini bir CredentialCache içinde depolayın ve bu özelliğe atayın. Bu özellik, bir dışında herhangi bir CredentialCacheşey içeriyorsa, yeniden yönlendirme sırasında otomatik olarak olarak ayarlanırnull. Bu özellik değerinin bu koşullar altında otomatik olarak olarak ayarlanması null , kimlik bilgilerinin istenmeyen herhangi bir hedefe gönderilmesini önler.

Şunlara uygulanır

Ayrıca bkz.

• NetworkCredential
• CredentialCache
• Credentials