WorkbookBase.XmlImport, méthode

Article
05/16/2013

Importe un fichier de données XML dans le classeur actif.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
Public Function XmlImport ( _
    url As String, _
    <OutAttribute> ByRef importMap As XmlMap, _
    overwrite As Object, _
    destination As Object _
) As XlXmlImportResult

public XlXmlImportResult XmlImport(
    string url,
    out XmlMap importMap,
    Object overwrite,
    Object destination
)

Paramètres

url
Type : System.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
Type : Microsoft.Office.Interop.Excel.XmlMap%
Mappage de schéma à appliquer lors de l'importation du fichier.

overwrite
Type : System.Object
Si aucune valeur n'est spécifiée pour le paramètre Destination, ce paramètre spécifie s'il convient de remplacer ou non les données qui ont été mappées vers le mappage de schéma spécifié dans le paramètre ImportMap.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 paramètre Destination, ce paramètre spécifie s'il convient ou non de remplacer 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.

destination
Type : System.Object
Les données seront importées dans une nouvelle liste XML du Range spécifié.

Valeur de retour

Type : Microsoft.Office.Interop.Excel.XlXmlImportResult
Une des valeurs de XlXmlImportResult.

Notes

Ne spécifiez pas de valeur pour le paramètre Destination si vous souhaitez importer les données dans un mappage existant.

En présence des conditions suivantes, cette méthode générera des erreurs d'exécution :

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 s'adapter à la feuille de calcul.

Utilisez la méthode XmlImportXml pour importer les données XML précédemment chargées dans la mémoire.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant crée un XmlMap basé sur un schéma généré à partir d'un DataSet, écrit le DataSet dans un fichier XML, puis utilise la méthode XmlImport pour écrire les données du fichier XML dans une plage de la feuille de calcul Sheet1.

Cet exemple illustre une personnalisation au niveau du document.

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

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);
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

WorkbookBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via