Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

API Reference

Class

EmailWriterOptions

Namespace OfficeIMO.Email
Assembly OfficeIMO.Email
Source revision 33d062b583cb with working tree changes
Modifiers sealed

Immutable policy for deterministic email serialization.

Inheritance

  • Object
  • EmailWriterOptions

Usage

Explore 23 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters 16

Constructors

EmailWriterOptions 3 overloads
public EmailWriterOptions(Boolean usePreservedRawSource = false, Boolean includeBccHeader = false, Int32 base64LineLength = 76, Int32 maxNestedMessageDepth = 16, Int64 maxOutputBytes = 536870912) #

Creates writer options.

Parameters

usePreservedRawSource System.Boolean = false optionalposition: 0
includeBccHeader System.Boolean = false optionalposition: 1
base64LineLength System.Int32 = 76 optionalposition: 2
maxNestedMessageDepth System.Int32 = 16 optionalposition: 3
maxOutputBytes System.Int64 = 536870912 optionalposition: 4
public EmailWriterOptions(EmailConversionLossPolicy conversionLossPolicy, Boolean usePreservedRawSource = false, Boolean includeBccHeader = false, Int32 base64LineLength = 76, Int32 maxNestedMessageDepth = 16, Int64 maxOutputBytes = 536870912) #

Creates writer options with an explicit semantic-loss policy.

Parameters

conversionLossPolicy OfficeIMO.Email.EmailConversionLossPolicy requiredposition: 0
usePreservedRawSource System.Boolean = false optionalposition: 1
includeBccHeader System.Boolean = false optionalposition: 2
base64LineLength System.Int32 = 76 optionalposition: 3
maxNestedMessageDepth System.Int32 = 16 optionalposition: 4
maxOutputBytes System.Int64 = 536870912 optionalposition: 5
public EmailWriterOptions(OfficeSignatureMutationPolicy signatureMutationPolicy, EmailConversionLossPolicy conversionLossPolicy = Block, Boolean usePreservedRawSource = false, Boolean includeBccHeader = false, Int32 base64LineLength = 76, Int32 maxNestedMessageDepth = 16, Int64 maxOutputBytes = 536870912) #

Creates writer options with an explicit policy for transport signatures invalidated by regeneration.

Parameters

signatureMutationPolicy OfficeIMO.OfficeSignatureMutationPolicy requiredposition: 0
conversionLossPolicy OfficeIMO.Email.EmailConversionLossPolicy = Block optionalposition: 1
usePreservedRawSource System.Boolean = false optionalposition: 2
includeBccHeader System.Boolean = false optionalposition: 3
base64LineLength System.Int32 = 76 optionalposition: 4
maxNestedMessageDepth System.Int32 = 16 optionalposition: 5
maxOutputBytes System.Int64 = 536870912 optionalposition: 6

Properties

public static EmailWriterOptions Default { get; } #

Default deterministic writer policy.

public Boolean UsePreservedRawSource { get; } #

Whether an unchanged preserved source should be emitted instead of regenerating the artifact.

public Boolean IncludeBccHeader { get; } #

Whether Bcc recipients are written into the message header.

public Int32 Base64LineLength { get; } #

Maximum encoded characters on one Base64 body line.

public Int32 MaxNestedMessageDepth { get; } #

Maximum embedded-message write depth.

public Int64 MaxOutputBytes { get; } #

Maximum serialized artifact size.

public EmailConversionLossPolicy ConversionLossPolicy { get; } #

Policy applied when the requested format cannot preserve known message semantics.

public OfficeSignatureMutationPolicy SignatureMutationPolicy { get; } #

Policy for DKIM, DomainKey, and ARC headers when serializing regenerated content. Defaults to blocking. This does not verify signatures or authorize rewriting a protected S/MIME wrapper.