WorkbookBase.XmlImport - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
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
)

Параметры

url
Тип: System.String
URL-адрес или UNC-путь для XML-файла данных.

importMap
Тип: Microsoft.Office.Interop.Excel.XmlMap%
Проекция схемы, применяемая при импорте файла.

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorkbookBase Класс

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

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