ContentDisposition.FileName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de voorgestelde bestandsnaam voor een e-mailbijlage op of stelt u deze in.
public:
property System::String ^ FileName { System::String ^ get(); void set(System::String ^ value); };
public string FileName { get; set; }
member this.FileName : string with get, set
Public Property FileName As String
Waarde van eigenschap
Een String met de bestandsnaam.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de waarde van deze eigenschap instelt.
public static void CreateMessageAttachment1(string server, string textMessage)
{
// Create a message and set up the recipients.
MailMessage message = new MailMessage(
"jane@contoso.com",
"ben@contoso.com",
"A text message for you.",
"Message: ");
// Attach the message string to this email message.
Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
ContentDisposition disposition = data.ContentDisposition;
// Suggest a file name for the attachment.
disposition.FileName = "message" + DateTime.Now.ToString();
message.Attachments.Add(data);
//Send the message.
SmtpClient client = new SmtpClient(server);
client.Credentials = CredentialCache.DefaultNetworkCredentials;
try
{
client.Send(message);
}
catch (Exception ex)
{
Console.WriteLine("Exception caught in CreateMessageAttachment1(): {0}",
ex.ToString());
}
// Display the values in the ContentDisposition for the attachment.
Console.WriteLine("Content disposition");
Console.WriteLine(disposition.ToString());
Console.WriteLine("File {0}", disposition.FileName);
Console.WriteLine("Size {0}", disposition.Size);
Console.WriteLine("Creation {0}", disposition.CreationDate);
Console.WriteLine("Modification {0}", disposition.ModificationDate);
Console.WriteLine("Read {0}", disposition.ReadDate);
Console.WriteLine("Inline {0}", disposition.Inline);
Console.WriteLine("Parameters: {0}", disposition.Parameters.Count);
foreach (DictionaryEntry d in disposition.Parameters)
{
Console.WriteLine("{0} = {1}", d.Key, d.Value);
}
data.Dispose();
}
Opmerkingen
Met FileName de eigenschap kan de afzender voorstellen dat de naam moet worden gebruikt voor het opslaan van een e-mailbijlage op de computer van de geadresseerde. Deze naam is alleen een suggestie; het ontvangende systeem kan het negeren. De naam mag geen padgegevens bevatten; dergelijke informatie wordt genegeerd door de ontvangende computer.
Als u informatie over de bestandsnaam wilt verwijderen, kunt u deze eigenschap null instellen op of op de lege tekenreeks ("").
De header Content-Disposition wordt beschreven in RFC 2183 dat beschikbaar is op https://www.ietf.org.