WorkbookBase.XmlImport(String, XmlMap, Object, Object) Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Xml veri dosyasını geçerli çalışma kitabına aktarır.

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

Parametreler

url

String

Xml veri dosyasının tekdüzen kaynak bulucu (URL) veya tekdüzen adlandırma kuralı (UNC) yolu.

importMap

XmlMap

Dosya içeri aktarırken uygulanacak şema eşlemesi.

overwrite

Object

Parametre için Destination bir değer belirtilmezse, bu parametre parametresinde ImportMap belirtilen şema eşlemesine eşlenmiş verilerin üzerine yazıp yazmayacağını belirtir. true Verilerin üzerine yazmak veya false yeni verileri mevcut verilere eklemek için olarak ayarlayın. true varsayılan değerdir. parametre için Destination bir değer belirtilirse, bu parametre varolan verilerin üzerine yazıp yazmayacağını belirtir. true Varolan verilerin üzerine yazmak veya false verilerin üzerine yazılacaksa içeri aktarma işlemini iptal etmek için olarak ayarlayın. true varsayılan değerdir.

destination

Object

Veriler belirtilen konumda Range yeni bir XML listesine aktarılacak.

Döndürülenler

XlXmlImportResult

Değerlerden XlXmlImportResult biri.

Örnekler

Aşağıdaki kod örneği, XmlMap öğesinden DataSetoluşturulan bir şemayı temel alan bir oluşturur, dosyasını bir XML dosyasına yazar DataSet ve ardından XML dosyasındaki verileri çalışma sayfasındaki Sheet1bir aralığa yazmak için yöntemini kullanırXmlImport.

Bu örnek, belge düzeyinde özelleştirme içindir

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

Açıklamalar

Verileri var olan bir eşlemeye Destination aktarmak istiyorsanız parametre için bir değer belirtmeyin.

Aşağıdaki koşullar bu yöntemin çalışma zamanı hataları oluşturmasına neden olur:

• Belirtilen XML verileri sözdizimi hataları içeriyor.

• Belirtilen veriler çalışma sayfasına sığamadığı için içeri aktarma işlemi iptal edildi.

XmlImportXml Daha önce belleğe yüklenmiş XML verilerini içeri aktarmak için yöntemini kullanın.

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümleri'nde İsteğe Bağlı Parametreler.