WebClient.UseDefaultCredentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение Boolean, которое управляет отправкой учетных данных DefaultCredentials вместе с запросами.
public:
property bool UseDefaultCredentials { bool get(); void set(bool value); };
public bool UseDefaultCredentials { get; set; }
member this.UseDefaultCredentials : bool with get, set
Public Property UseDefaultCredentials As Boolean
Значение свойства
Значение true
, если используются учетные данные по умолчанию; в противном случае — значение false
. Значение по умолчанию — false
.
Примеры
В следующем примере кода показано задание этого свойства.
// Sample call: UploadFileInBackground3("http://www.contoso.com/fileUpload.aspx", "data.txt")
void UploadFileInBackground3( String^ address, String^ fileName )
{
WebClient^ client = gcnew WebClient;
Uri ^uri = gcnew Uri(address);
client->UseDefaultCredentials = true;
client->UploadFileCompleted += gcnew UploadFileCompletedEventHandler( UploadFileCallback2 );
client->UploadFileAsync( uri, fileName );
Console::WriteLine( "File upload started." );
}
// Sample call: UploadFileInBackground3("http://www.contoso.com/fileUpload.aspx", "data.txt")
public static void UploadFileInBackground3(string address, string fileName)
{
WebClient client = new WebClient();
Uri uri = new Uri(address);
client.UseDefaultCredentials = true;
client.UploadFileCompleted += new UploadFileCompletedEventHandler(UploadFileCallback2);
client.UploadFileAsync(uri, fileName);
Console.WriteLine("File upload started.");
}
' Sample call: UploadFileInBackground3("http:' www.contoso.com/fileUpload.aspx", "data.txt")
Public Shared Sub UploadFileInBackground3(ByVal address As String, ByVal fileName As String)
Dim client As WebClient = New WebClient()
Dim uri as Uri = New Uri(address)
client.UseDefaultCredentials = True
AddHandler client.UploadFileCompleted, AddressOf UploadFileCallback2
client.UploadFileAsync(uri, fileName)
Console.WriteLine("File upload started.")
End Sub
Комментарии
Задайте для этого свойства true
значение, когда запросы, выполненные этим WebClient объектом, должны проходить проверку подлинности с помощью учетных данных по умолчанию пользователя, вошедшего в систему. Для клиентских приложений это необходимое поведение в большинстве сценариев. Для приложений среднего уровня, таких как ASP.NET приложения, вместо использования этого свойства обычно необходимо задать Credentials для свойства учетные данные клиента, от имени которого выполняется запрос.