AltChunk Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la classe AltChunk.
Cette classe est disponible dans Office 2007 et versions ultérieures.
Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :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
- Héritage
- Héritage
- Attributs
Exemples
L’exemple suivant montre comment fusionner deux documents de traitement de texte à l’aide altChunk
de . L’exemple insère le contenu du fichier (source.docx) dans un autre fichier (Destination.docx). Après avoir exécuté l’exemple, examinez le contenu du fichier « Destination.docx ». Vous remarquerez que le contenu du fichier source est inséré juste après le texte qui se trouvait à l’origine dans le fichier. Notez également que l’exemple de code commence par supprimer le fichier « Destination.docx » et en crée un nouveau. Cela permet d’éviter le conflit d’ID lorsque vous exécutez le code plusieurs fois.
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
Remarques
[ISO/IEC 29500-1 1st Edition]
altChunk (Ancre pour le contenu externe importé)
Cet élément spécifie un emplacement dans un document pour l’insertion du contenu d’un fichier spécifié contenant du contenu externe à importer dans le main document WordprocessingML. Le contenu du fichier spécifié doit apparaître à l’emplacement spécifié dans le document et peut désormais être émis en tant que WordprocessingML standard sans distinction de son origine. L’emplacement du contenu externe à importer doit être spécifié par la relation dont l’attribut Id correspond à l’attribut id sur cet élément.
Si le type de relation de la relation spécifiée par cet élément n’est pas http://schemas.openxmlformats.org/officeDocument/2006/afChunk, n’est pas présent ou n’a pas de valeur d’attribut TargetMode Interne, le document est considéré comme non conforme. Si une application ne peut pas traiter le contenu externe du type de contenu spécifié par la partie ciblée, elle doit ignorer le contenu de remplacement spécifié, mais continuer à traiter le fichier. Si possible, elle doit également indiquer que le contenu inconnu n’a pas été importé.
[Exemple : Prenons un document WordprocessingML composé de contenu qui doit être importé à partir du document HTML suivant :
<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>
Le document hôte WordprocessingML obtenu se composerait de son propre contenu WordprocessingML ainsi que d’une ancre d’importation de contenu externe à l’emplacement approprié :
<w:body>
<w:altChunk r:id="altChunk1" />
<w:p/>
<w:sectPr>
… </w:sectPr>
</w:body>
L’élément altChunk spécifie que le contenu externe ciblé par la relation avec un ID altChunk1 doit être importé au début du document. En examinant le contenu de l’élément de partie de relation correspondant, nous pouvons voir les cibles pour cette relation :
<Relationships … >
… <Relationship Id="altChunk1" TargetMode="Internal" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/afChunk" Target="import.htm" />
…</Relationships>
L’élément de partie de relation correspondant indique que le fichier à importer se trouve à côté du document main et est nommé import.htm. Fin de l’exemple]
Éléments parents |
---|
corps (§17.2.2) ; commentaire (§17.13.4.2) ; docPartBody (§17.12.6) ; note de fin (§17.11.2) ; note de bas de page (§17.11.10) ; ftr (§17.10.3) ; hdr (§17.10.4) ; tc (§17.4.66) |
Éléments enfants | Paragraphe |
---|---|
altChunkPr (propriétés d’importation de contenu externe) | §17.17.2.2 |
[Remarque : La définition de schéma XML W3C du modèle de contenu (CT_AltChunk) de cet élément se trouve dans §A.1. Fin de la remarque]
ISO/IEC29500 : 2008.
Constructeurs
AltChunk() |
Initialise une nouvelle instance de la classe AltChunk. |
AltChunk(IEnumerable<OpenXmlElement>) |
Initialise une nouvelle instance de la classe AltChunk avec les éléments enfants spécifiés. |
AltChunk(OpenXmlElement[]) |
Initialise une nouvelle instance de la classe AltChunk avec les éléments enfants spécifiés. |
AltChunk(String) |
Initialise une nouvelle instance de la classe AltChunk à partir d’un code XML externe. |
Propriétés
AltChunkProperties |
Propriétés d’importation de contenu externe. Représente la balise d’élément suivante dans le schéma : w :altChunkPr. |
ChildElements |
Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement) |
ExtendedAttributes |
Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement) |
Features |
Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement) |
FirstChild |
Obtient le premier enfant de l’élément OpenXmlElement actuel. (Hérité de OpenXmlCompositeElement) |
HasAttributes |
Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement) |
HasChildren |
Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlCompositeElement) |
Id |
Relation au composant Représente l’attribut suivant dans le schéma : r :id |
InnerText |
Obtient ou définit les valeurs concaténées du nœud actuel et de tous ses enfants. (Hérité de OpenXmlCompositeElement) |
InnerXml |
Obtient ou définit le balisage qui représente uniquement les nœuds enfants du nœud actuel. (Hérité de OpenXmlCompositeElement) |
LastChild |
Obtient le dernier enfant de l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlCompositeElement) |
LocalName |
Définit la classe AltChunk. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :altChunk. |
LocalName |
Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement) |
MCAttributes |
Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement) |
NamespaceDeclarations |
Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement) |
NamespaceUri |
Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement) |
OpenXmlElementContext |
Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement) |
OuterXml |
Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement) |
Parent |
Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement) |
Prefix |
Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement) |
XmlQualifiedName |
Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement) |
XName |
Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement) |
Méthodes
AddAnnotation(Object) |
Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
AddChild(OpenXmlElement, Boolean) |
Ajoute l’élément spécifié à l’élément s’il s’agit d’un enfant connu. Cela ajoute l’élément à l’emplacement approprié en fonction du schéma. (Hérité de OpenXmlCompositeElement) |
AddNamespaceDeclaration(String, String) |
Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement) |
Ancestors() |
Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement) |
Ancestors<T>() |
Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement) |
Annotation(Type) |
Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
Annotation<T>() |
Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
Annotations(Type) |
Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
Annotations<T>() |
Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
Append(IEnumerable<OpenXmlElement>) |
Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
Append(OpenXmlElement[]) |
Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement) |
AppendChild<T>(T) |
Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement) |
ClearAllAttributes() |
Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement) |
Clone() |
Crée un doublon du nœud actuel. (Hérité de OpenXmlElement) |
CloneNode(Boolean) |
Crée un doublon de ce nœud. |
Descendants() |
Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement) |
Descendants<T>() |
Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement) |
Elements() |
Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement) |
Elements<T>() |
Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement) |
ElementsAfter() |
Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement) |
ElementsBefore() |
Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement) |
GetAttribute(String, String) |
Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement) |
GetAttributes() |
Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement) |
GetEnumerator() |
Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement) |
GetFirstChild<T>() |
Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement) |
InsertAfter<T>(T, OpenXmlElement) |
Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement) |
InsertAfterSelf<T>(T) |
Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement) |
InsertAt<T>(T, Int32) |
Insère l’élément spécifié à l’index spécifié des enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement) |
InsertBefore<T>(T, OpenXmlElement) |
Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlCompositeElement) |
InsertBeforeSelf<T>(T) |
Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement) |
IsAfter(OpenXmlElement) |
Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement) |
IsBefore(OpenXmlElement) |
Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement) |
LookupNamespace(String) |
Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement) |
LookupPrefix(String) |
Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement) |
NextSibling() |
Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement) |
NextSibling<T>() |
Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement) |
PrependChild<T>(T) |
Insère l’élément spécifié au début de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement) |
PreviousSibling() |
Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement) |
PreviousSibling<T>() |
Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement) |
Remove() |
Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement) |
RemoveAllChildren() |
Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlCompositeElement) |
RemoveAllChildren<T>() |
Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement) |
RemoveAnnotations(Type) |
Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
RemoveAnnotations<T>() |
Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement) |
RemoveAttribute(String, String) |
Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement) |
RemoveChild<T>(T) |
Supprime l’élément enfant spécifié. (Hérité de OpenXmlCompositeElement) |
RemoveNamespaceDeclaration(String) |
Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement) |
ReplaceChild<T>(OpenXmlElement, T) |
Remplace l’un des éléments enfants de l’élément actuel par un autre élément OpenXmlElement. (Hérité de OpenXmlCompositeElement) |
SetAttribute(OpenXmlAttribute) |
Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement) |
SetAttributes(IEnumerable<OpenXmlAttribute>) |
Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement) |
WriteTo(XmlWriter) |
Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement) |
Implémentations d’interfaces explicites
IEnumerable.GetEnumerator() |
Définit la classe AltChunk. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est w :altChunk. (Hérité de OpenXmlElement) |
IEnumerable<OpenXmlElement>.GetEnumerator() |
Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement) |