AltChunk 类

定义

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(23, "altChunk")]
public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr(23, "altChunk")]
public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("w:altChunk")]
public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.SchemaAttr("w:altChunk")]
public class AltChunk : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))]
public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class AltChunk : DocumentFormat.OpenXml.OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(23, "altChunk")>]
type AltChunk = class
    inherit OpenXmlCompositeElement

type AltChunk = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr(23, "altChunk")>]
type AltChunk = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("w:altChunk")>]
type AltChunk = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.SchemaAttr("w:altChunk")>]
type AltChunk = class
    inherit TypedOpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))>]
type AltChunk = class
    inherit OpenXmlCompositeElement

[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Wordprocessing.AltChunkProperties))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type AltChunk = class
    inherit OpenXmlCompositeElement

Public Class AltChunk
Inherits OpenXmlCompositeElement

Public Class AltChunk
Inherits TypedOpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

AltChunk

继承

Object

OpenXmlElement

OpenXmlCompositeElement

TypedOpenXmlCompositeElement

AltChunk

属性

ChildElementInfoAttribute OfficeAvailabilityAttribute SchemaAttrAttribute

示例

以下示例演示如何使用 altChunk合并两个字处理文档。 该示例将文件的内容 (source.docx) 插入另一个文件 (Destination.docx) 。 运行示例后，检查文件的内容“Destination.docx”。 你会注意到，源文件的内容直接插入到最初位于文件中的文本之后。 另请注意，代码示例首先删除文件“Destination.docx”并创建一个新的文件。 这是为了避免多次运行代码时出现 ID 冲突。

using System.Linq;  
using System.IO;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Wordprocessing;  
namespace altChunk  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {            
            string fileName1 = @"c:\Users\Public\Documents\Destination.docx";  
            string fileName2 = @"c:\Users\Public\Documents\Source.docx";  
            string testFile = @"c:\Users\Public\Documents\Test.docx";  
            File.Delete(fileName1);  
            File.Copy(testFile, fileName1);  
            using (WordprocessingDocument myDoc =  
                WordprocessingDocument.Open(fileName1, true))  
            {  
                string altChunkId = "AltChunkId1";  
                MainDocumentPart mainPart = myDoc.MainDocumentPart;  
                AlternativeFormatImportPart chunk =   
                    mainPart.AddAlternativeFormatImportPart(  
                    AlternativeFormatImportPartType.WordprocessingML, altChunkId);  
                using (FileStream fileStream = File.Open(fileName2, FileMode.Open))  
                    chunk.FeedData(fileStream);  
                AltChunk altChunk = new AltChunk();  
                altChunk.Id = altChunkId;  
                mainPart.Document  
                    .Body  
                    .InsertAfter(altChunk, mainPart.Document.Body  
                    .Elements<Paragraph>().Last());  
                mainPart.Document.Save();  
            }             
        }  
    }  
}  

Imports System.Linq  
Imports System.IO  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Wordprocessing  

Module Module1  
    Sub Main(ByVal args As String())  
        Dim fileName1 As String = "c:\Users\Public\Documents\Destination.docx"  
        Dim fileName2 As String = "c:\Users\Public\Documents\Source.docx"  
        Dim testFile As String = "c:\Users\Public\Documents\Test.docx"  
        File.Delete(fileName1)  
        File.Copy(testFile, fileName1)  
        Using myDoc As WordprocessingDocument = WordprocessingDocument.Open(fileName1, True)  
            Dim altChunkId As String = "AltChunkId1"  
            Dim mainPart As MainDocumentPart = myDoc.MainDocumentPart  
            Dim chunk As AlternativeFormatImportPart = mainPart.AddAlternativeFormatImportPart(AlternativeFormatImportPartType.WordprocessingML, altChunkId)  
            Using fileStream As FileStream = File.Open(fileName2, FileMode.Open)  
                chunk.FeedData(fileStream)  
            End Using  
            Dim altChunk As New AltChunk()  
            altChunk.Id = altChunkId  
            mainPart.Document.Body.InsertAfter(altChunk, mainPart.Document.Body.Elements(Of Paragraph)().Last())  
            mainPart.Document.Save()  
        End Using  
    End Sub  
End Module  

注解

[ISO/IEC 29500-1 第 1 版]

altChunk (导入的外部内容定位点)

此元素指定文档中的一个位置，用于插入包含要导入到 wordprocessingML 文档中main外部内容的指定文件的内容。 指定文件的内容应出现在文档中的指定位置，并且以后可以不区分其来源而作为常规 WordprocessingML 发出。 要导入的外部内容的位置应由 Id 属性与此元素上的 id 属性匹配的关系指定。

如果此元素指定的关系类型不是 http://schemas.openxmlformats.org/officeDocument/2006/afChunk、不存在或没有 TargetMode 属性值为 Internal，则文档应被视为不一致。 如果应用程序无法处理目标部件指定的内容类型的外部内容，则它应忽略指定的备用内容，但应继续处理该文件。 如果可能，它还应提供一些未导入未知内容的指示。

[示例：假设 WordprocessingML 文档包含必须从以下 HTML 文档导入的内容：

<html … >  
  <body style="margin-left:200px;margin-top:50px">  
    <p>Paragraph one.</p>  
    <blockquote style="border:5px solid #00FFFF">Paragraph in a blockquote.</blockquote>  
    <p>Paragraph two.</p>  
  </body>  
</html>  

生成的 WordprocessingML 主机文档将包含其自己的 WordprocessingML 内容以及位于相应位置的外部内容导入定位点：

<w:body>  
  <w:altChunk r:id="altChunk1" />  
  <w:p/>  
  <w:sectPr>  
    …  </w:sectPr>  
</w:body>  

altChunk 元素指定必须在文档开头导入 ID 为 altChunk1 的关系所面向的外部内容。 检查相应关系部分项的内容，可以看到该关系的目标：

<Relationships … >  
  …  <Relationship Id="altChunk1" TargetMode="Internal" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/afChunk" Target="import.htm" />  
  …</Relationships>  

相应的关系部件项显示要导入的文件位于main文档旁边，名为 import.htm。 示例结束]

[注意：此元素的内容模型 (CT_AltChunk) 的 W3C XML 架构定义位于 §A.1 中。 注释结束]

ISO/IEC29500：2008。