ContentDisposition.DispositionType Propriedade

Definição

Obtém ou define o tipo de disposição de um anexo de email.Gets or sets the disposition type for an email attachment.

public:
 property System::String ^ DispositionType { System::String ^ get(); void set(System::String ^ value); };
public string DispositionType { get; set; }
member this.DispositionType : string with get, set
Public Property DispositionType As String

Valor da propriedade

String

Um String que contém o tipo de disposição.A String that contains the disposition type. O valor não é restrito, mas normalmente é um dos valores DispositionType.The value is not restricted but is typically one of the DispositionType values.

Exceções

O valor especificado para uma operação de definição é null.The value specified for a set operation is null.

O valor especificado para uma operação de conjuntos é igual a Empty ("").The value specified for a set operation is equal to Empty ("").

Exemplos

O exemplo de código a seguir demonstra como definir o valor dessa propriedade.The following code example demonstrates how to set the value of this property.

static void CreateMessageWithAttachment4( String^ server, String^ to )
{
   
   // Specify the file to be attached and sent.
   // This example uses a file on a UNC share.
   String^ file = L"\\\\share3\\c$\\reports\\data.xls";
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"ReportMailer@contoso.com",to,L"Quarterly data report",L"See the attached spreadsheet." );
   
   // Create  the file attachment for this email message.
   Attachment^ data = gcnew Attachment("qtr3.xls", MediaTypeNames::Application::Octet);
   
   // Add time stamp information for the file.
   ContentDisposition^ disposition = data->ContentDisposition;
   disposition->CreationDate = System::IO::File::GetCreationTime( file );
   disposition->ModificationDate = System::IO::File::GetLastWriteTime( file );
   disposition->ReadDate = System::IO::File::GetLastAccessTime( file );
   disposition->DispositionType = DispositionTypeNames::Attachment;
   
   // Add the file attachment to this email message.
   message->Attachments->Add( data );
   
   //Send the message.
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Add credentials if the SMTP server requires them.
   client->Credentials = dynamic_cast<ICredentialsByHost^>(CredentialCache::DefaultNetworkCredentials);
   client->Send( message );
   
   // Display the message headers.
   array<String^>^keys = message->Headers->AllKeys;
   Console::WriteLine( L"Headers" );
   IEnumerator^ myEnum3 = keys->GetEnumerator();
   while ( myEnum3->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum3->Current);
      Console::WriteLine( L"{0}:", s );
      Console::WriteLine( L"    {0}", message->Headers[ s ] );
   }

   data->~Attachment();
   client->~SmtpClient();
}


public static void CreateMessageWithAttachment4(string server, string to)
{
    // Specify the file to be attached and sent.
    // This example uses a file on a UNC share.
    string file = @"\\share3\c$\reports\data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "ReportMailer@contoso.com",
       to,
       "Quarterly data report",
       "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment("qtr3.xls", MediaTypeNames.Application.Octet);
    // Add time stamp information for the file.
    ContentDisposition disposition = data.ContentDisposition;
    disposition.CreationDate = System.IO.File.GetCreationTime(file);
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
    disposition.DispositionType = DispositionTypeNames.Attachment;
    // Add the file attachment to this email message.
    message.Attachments.Add(data);
    //Send the message.
    SmtpClient client = new SmtpClient(server);
    // Add credentials if the SMTP server requires them.
    client.Credentials = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the message headers.
    string[] keys = message.Headers.AllKeys;
    Console.WriteLine("Headers");
    foreach (string s in keys)
    {
        Console.WriteLine("{0}:", s);
        Console.WriteLine("    {0}", message.Headers[s]);
    }
    data.Dispose();
}

Comentários

O DispositionType valor da propriedade pode ser usado pelo software que exibe o email para determinar a maneira correta de apresentar os anexos de email.The DispositionType property value can be used by software that displays email to determine the correct way to present the email attachments. Inline os anexos são geralmente exibidos quando o usuário abre o email.Inline attachments are usually displayed when the user opens the email. Attachment os anexos geralmente não são abertos até que o usuário execute alguma ação, como clicar em um ícone que representa o anexo.Attachment attachments are usually not opened until the user performs some action, such as clicking an icon that represents the attachment.

O cabeçalho de disposição de conteúdo é descrito em RFC 2183 disponível em https://www.ietf.org .The Content-Disposition header is described in RFC 2183 available at https://www.ietf.org.

Aplica-se a