AddressFieldName Class
Column Containing E-mail Address.When the object is serialized out as xml, its qualified name is w:addressFieldName.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlLeafElement
DocumentFormat.OpenXml.Wordprocessing.StringType
DocumentFormat.OpenXml.Wordprocessing.AddressFieldName
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
Public Class AddressFieldName _
Inherits StringType
'Usage
Dim instance As AddressFieldName
public class AddressFieldName : StringType
Remarks
[ISO/IEC 29500-1 1st Edition]
17.14.3 addressFieldName (Column Containing E-mail Address)
This element specifies the column within a given external data source that contains e-mail addresses. This element is specified independently of the field mappings specified for a given merged document via the fieldMapData element (§17.14.15).
If this element is omitted, or no column exists in the data source with this column name, then the source document specifies that no e-mail address data shall be associated with this mail merge.
[Note: This element is generally used to allow the e-mailing of merged documents resulting from populating the fields within a merged document with external data.
This element is independent of the field mapping specified for a given merged document via the fieldMapData element (§17.14.15). This separation enables applications to email the documents resulting from the population of WordprocessingML fields with external data regardless of the presence or absence of a field mapped to external data specifying email addresses. end note]
[Example: Consider a merged WordprocessingML document that is connected to an external data source containing a column of data tilted Alternate Email Addresses. The following WordprocessingML would be included in the source and merged documents to specify which column in the external data source contains email addresses.
<w:addressFieldName w:val="Alternate Email Address" />
The addressFieldName element specifies that the Alternate Email Address column contains e-mail addresses for each record. end example]
Parent Elements |
|---|
mailMerge (§17.14.20) |
Attributes |
Description |
|---|---|
val (String Value) |
Specifies that its contents contain a string. The contents of this string are interpreted based on the context of the parent XML element. [Example: Consider the following WordprocessingML fragment: <w:pPr> <w:pStyle w:val="heading1" /> </w:pPr> The value of the val attribute is the ID of the associated paragraph style's styleId. However, consider the following fragment: <w:sdtPr> <w:alias w:val="SDT Title Example" /> … </w:sdtPr> In this case, the decimal number in the val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_String simple type (§22.9.2.13). |
[Note: The W3C XML Schema definition of this element’s content model (CT_String) is located in §A.1. end note]
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.