WebClient.Credentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает учетные данные сети, которые передаются на узел и используются для проверки подлинности запроса.
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, которые являются учетными данными текущего пользователя, выполнившего вход. Для этого присвойте свойству UseDefaultCredentials значение true
, а не это свойство.
WebClient Если класс используется в приложении среднего уровня, например в приложении ASP.NET, DefaultCredentials класс принадлежит учетной записи, на которой выполняется ASP-страница (учетные данные на стороне сервера). Как правило, для этого свойства задаются учетные данные клиента, от имени которого выполняется запрос.
В целях безопасности при автоматическом выполнении перенаправлений сохраните учетные данные, которые вы хотите включить в перенаправление CredentialCache , в и назначьте их этому свойству. При перенаправлении этому свойству CredentialCacheавтоматически присваивается значение null
, если оно содержит что-либо, кроме . Автоматическое присвоение этому свойству null
значения в соответствии с этими условиями предотвращает отправку учетных данных в любое непреднамеренное назначение.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по