WebClient.Credentials 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
호스트에 전송되어 요청을 인증하는 데 사용되는 네트워크 자격 증명을 가져오거나 설정합니다.
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
속성 값
요청에 대한 인증 자격 증명이 들어 있는 ICredentials입니다. 기본값은 null
입니다.
예제
다음 코드 예제에서는 사용자의 시스템 자격 증명을 사용하여 요청을 인증합니다.
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
설명
속성에는 Credentials 호스트의 리소스에 액세스하는 데 사용되는 인증 자격 증명이 포함되어 있습니다. 대부분의 클라이언트 쪽 시나리오에서는 현재 로그온한 사용자의 자격 증명인 를 사용해야 DefaultCredentials합니다. 이렇게 하려면 이 속성을 설정하는 대신 속성을 true
로 설정합니다UseDefaultCredentials.
클래스가 WebClient 중간 계층 애플리케이션(예: ASP.NET 애플리케이션)에서 사용되는 경우 는 DefaultCredentials ASP 페이지(서버 쪽 자격 증명)를 실행하는 계정에 속합니다. 일반적으로 요청을 대신하는 클라이언트의 자격 증명으로 이 속성을 설정합니다.
보안상의 이유로 리디렉션을 자동으로 따르는 경우 리디렉션에 포함하려는 자격 증명을 에 CredentialCache 저장하고 이 속성에 할당합니다. 이 속성은 를 제외한 CredentialCache모든 항목이 포함된 경우 리디렉션 시 자동으로 로 설정 null
됩니다. 이러한 조건에서 이 속성 값을 자동으로 로 설정 null
하면 자격 증명이 의도하지 않은 대상으로 전송되지 않습니다.
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기