SmtpClient.UseDefaultCredentials プロパティ

定義

名前空間:

System.Net.Mail

アセンブリ:

System.Net.Mail.dll

ソース:

SmtpClient.cs

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

プロパティ値

Boolean

既定の資格情報を使用する場合は true。それ以外の場合は false。 既定値は false です。

例外

InvalidOperationException

電子メールが送信中の場合、このプロパティの値は変更できません。

例

次のコード例では、このプロパティの使用方法を示します。

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->UseDefaultCredentials = true;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

注釈

一部の SMTP サーバーでは、サーバーが代理で電子メールを送信する前にクライアントを認証する必要があります。 このオブジェクトがサーバーから要求された場合、現在ログオンしているユーザーの既定の資格情報を使用して認証する必要がある場合SmtpClientは、このプロパティtrueを に設定します。 クライアント アプリケーションの場合、これはほとんどのシナリオで望ましい動作です。

資格情報は、アプリケーションおよびコンピューターの構成ファイルを使用して指定することもできます。 詳細については、「mailSettings> 要素 (ネットワーク設定)」を参照してください<。

プロパティが UseDefaultCredentials に設定されている場合、サーバーに false, 接続するときに、 プロパティに Credentials 設定された値が資格情報に使用されます。 プロパティが UseDefaultCredentials に false 設定されていて、 Credentials プロパティが設定されていない場合、メールは匿名でサーバーに送信されます。

注意事項

基本認証の資格情報を指定した場合、資格情報はクリア テキストでサーバーに送信されます。 これにより、資格情報が表示され、他のユーザーが使用できるため、セキュリティの問題が発生する可能性があります。