WebClient.Credentials Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Kaynak:

WebClient.cs

Konağa gönderilen ve isteğin kimliğini doğrulamak için kullanılan ağ kimlik bilgilerini alır veya ayarlar.

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

Özellik Değeri

ICredentials

İstek için kimlik doğrulama kimlik bilgilerini içeren bir ICredentials. 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

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Credentials özelliği, 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 DefaultCredentialskullanmalısınız. Bunu yapmak için bu özelliği ayarlamak yerine UseDefaultCredentials özelliğini true olarak ayarlayın.

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 nedeniyle, yeniden yönlendirmeleri otomatik olarak takip ederken, yeniden yönlendirmeye eklenmesini istediğiniz kimlik bilgilerini bir CredentialCache depolayın ve bu özelliğe atayın. Bu özellik, CredentialCachedışında bir şey içeriyorsa yeniden yönlendirmeden sonra otomatik olarak null olarak ayarlanır. Bu özellik değerinin bu koşullar altında otomatik olarak null olarak ayarlanması, kimlik bilgilerinin istenmeyen herhangi bir hedefe gönderilmesini önler.

Ayrıca bkz.

• NetworkCredential
• CredentialCache
• Credentials