Поделиться через

Workbook.XmlImport Метод (2007 System)

  • Статья

Обновлен: Ноябрь 2007

Выполняет импорт XML-файла данных в текущую книгу.

Пространство имен:  Microsoft.Office.Tools.Excel
Сборка:  Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Function XmlImport ( _
    Url As String, _
    <OutAttribute> ByRef ImportMap As XmlMap, _
    Overwrite As Object, _
    Destination As Object _
) As XlXmlImportResult
'Применение
Dim instance As Workbook
Dim Url As String
Dim ImportMap As XmlMap
Dim Overwrite As Object
Dim Destination As Object
Dim returnValue As XlXmlImportResult

returnValue = instance.XmlImport(Url, _
    ImportMap, Overwrite, Destination)

public XlXmlImportResult XmlImport(
    string Url,
    out XmlMap ImportMap,
    Object Overwrite,
    Object Destination
)

Параметры

  • Url
    Тип: System.String
    URL-адрес или UNC-путь для XML-файла данных.
  • Overwrite
    Тип: System.Object
    Если для параметра Destination не указано значение, то этот параметр указывает, выполняется ли замена данных, которые были сопоставлены проекции схемы, заданной параметром ImportMap. Значение true для перезаписи данных, значение false для добавления новых данных к существующим. Значение по умолчанию — true. Если для параметра Destination задано значение, то этот параметр указывает, выполняется ли замена существующих данных. Значение true для перезаписи существующих данных, значение false для отмены импорта, если данные подлежат замене. Значение по умолчанию — true.
  • Destination
    Тип: System.Object
    Данные импортируются в новый XML-список в указанном диапазоне Range.

Возвращаемое значение

Тип: Microsoft.Office.Interop.Excel.XlXmlImportResult
Одно из значений XlXmlImportResult.

Заметки

Если требуется импортировать данные в существующее сопоставление, не указывайте значение для параметра Destination.

При следующих условиях методом создается ошибка во время выполнения:

  • указанные XML-данные содержат синтаксические ошибки;

  • импорт был отменен в связи с тем, что указанные данные не помещаются на листе.

Метод XmlImportXml используется для импорта XML-данных, предварительно загруженных в память.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем примере кода создается объект XmlMap, основанный на схеме, созданной из объекта DataSet, выполнятся запись DataSet в XML-файл, затем вызывается метод XmlImport для записи данных в XML-файл в диапазон ячеек на листе Sheet1.

В этом примере демонстрируется настройка уровня документа.

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", missing];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

Разрешения

См. также

Ссылки

Workbook Класс

Workbook - члены

Microsoft.Office.Tools.Excel - пространство имен