WorkbookBase.XmlImport(String, XmlMap, Object, Object) Méthode
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.
Importe un fichier de données XML dans le classeur actif.
public Microsoft.Office.Interop.Excel.XlXmlImportResult XmlImport (string url, out Microsoft.Office.Interop.Excel.XmlMap importMap, object overwrite, object destination);
member this.XmlImport : string * XmlMap * obj * obj -> Microsoft.Office.Interop.Excel.XlXmlImportResult
Public Function XmlImport (url As String, ByRef importMap As XmlMap, Optional overwrite As Object, Optional destination As Object) As XlXmlImportResult
Paramètres
- url
- String
URL (Uniform Resource Locator) ou chemin d'accès UNC (convention d'affectation de noms uniforme) vers un fichier de données XML.
- importMap
- XmlMap
Mappage de schéma à appliquer lors de l'importation du fichier.
- overwrite
- Object
Si aucune valeur n’est spécifiée pour le Destination
paramètre, ce paramètre spécifie s’il faut remplacer ou non les données qui ont été mappées au mappage de schéma spécifié dans le ImportMap
paramètre . Affectez la valeur true
pour remplacer les données ou false
pour ajouter les nouvelles données aux données existantes. La valeur par défaut est true
. Si une valeur est spécifiée pour le Destination
paramètre, ce paramètre spécifie s’il faut remplacer ou non les données existantes. Affectez la valeur true
pour remplacer les données existantes ou false
pour annuler l'importation si les données étaient remplacées. La valeur par défaut est true
.
Retours
Une des valeurs de l'objet XlXmlImportResult.
Exemples
L’exemple de code suivant crée un XmlMap basé sur un schéma généré à partir d’un DataSet, écrit dans DataSet un fichier XML, puis utilise la XmlImport méthode pour écrire les données du fichier XML dans une plage de feuille de calcul Sheet1
.
Cet exemple concerne une personnalisation au niveau du document.
private void WorkbookXmlImport()
{
// Create a new DataTable.
DataSet ds = new DataSet();
DataTable dt = ds.Tables.Add("Customers");
dt.Columns.Add(new DataColumn("LastName"));
dt.Columns.Add(new DataColumn("FirstName"));
// Add a new row to the DataTable.
DataRow dr = dt.NewRow();
dr["LastName"] = "Chan";
dr["FirstName"] = "Gareth";
dt.Rows.Add(dr);
// Add a new XML map and write the XML to a file.
Excel.XmlMap xmlMap1 = this.XmlMaps.Add(ds.GetXmlSchema(),
"NewDataSet");
ds.WriteXml(@"C:\Customers.xml");
// Import the XML from the file.
Excel.Range range1 = Globals.Sheet1.Range["A1"];
this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}
Private Sub WorkbookXmlImport()
' Create a new DataTable.
Dim ds As New DataSet()
Dim dt As DataTable = ds.Tables.Add("Customers")
dt.Columns.Add(New DataColumn("LastName"))
dt.Columns.Add(New DataColumn("FirstName"))
' Add a new row to the DataTable.
Dim dr As DataRow = dt.NewRow()
dr("LastName") = "Chan"
dr("FirstName") = "Gareth"
dt.Rows.Add(dr)
' Add a new XML map and write the XML to a file.
Dim xmlMap1 As Excel.XmlMap = Me.XmlMaps.Add(ds.GetXmlSchema(), _
"NewDataSet")
ds.WriteXml("C:\Customers.xml")
' Import the XML from the file.
Dim range1 As Excel.Range = Globals.Sheet1.Range("A1")
Me.XmlImport("C:\Customers.xml", xmlMap1, True, _
range1)
End Sub
Remarques
Ne spécifiez pas de valeur pour le Destination
paramètre si vous souhaitez importer des données dans un mappage existant.
Les conditions suivantes entraînent la génération d’erreurs d’exécution par cette méthode :
Les données XML spécifiées contiennent des erreurs de syntaxe.
Le processus d’importation a été annulé, car les données spécifiées ne peuvent pas tenir dans la feuille de calcul.
Utilisez la XmlImportXml méthode pour importer des données XML qui ont été précédemment chargées en mémoire.
Paramètres facultatifs
Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.