WorkbookBase.XmlImport(String, XmlMap, Object, Object) 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Excel

어셈블리:

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

XML 데이터 파일을 현재 통합 문서로 가져옵니다.

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

매개 변수

url

String

XML 데이터 파일에 대한 URL(Uniform Resource Locator) 또는 UNC(Uniform Naming Convention) 경로입니다.

importMap

XmlMap

파일을 가져올 때 적용할 스키마 맵입니다.

overwrite

Object

매개 변수에 대해 Destination 값을 지정하지 않으면 이 매개 변수는 매개 변수에 지정된 스키마 맵에 매핑된 ImportMap 데이터를 덮어쓸지 여부를 지정합니다. 데이터를 덮어쓰려면 true로 설정하고, 기존 데이터에 새 데이터를 추가하려면 false로 설정합니다. 기본값은 true입니다. 매개 변수에 값을 Destination 지정하는 경우 이 매개 변수는 기존 데이터를 덮어쓸지 여부를 지정합니다. 기존 데이터를 덮어쓰려면 true로 설정하고, 데이터를 덮어쓰게 될 경우 가져오기를 취소하려면 false로 설정합니다. 기본값은 true입니다.

destination

Object

데이터를 새 XML 목록의 지정된 Range로 가져옵니다.

반환

XlXmlImportResult

XlXmlImportResult 값 중 하나입니다.

예제

다음 코드 예제에서는 에서 생성 된 DataSet스키마를 기반으로 을 만들고 XmlMap XML 파일에 을 쓴 DataSet 다음 메서드를 사용하여 XmlImport XML 파일의 데이터를 워크시트의 Sheet1범위에 씁니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

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

설명

기존 매핑으로 데이터를 가져오려면 매개 변수의 값을 Destination 지정하지 마세요.

다음 조건에서는 이 메서드가 런타임 오류를 생성합니다.

• 지정된 XML 데이터에는 구문 오류가 포함됩니다.

• 지정한 데이터가 워크시트에 맞지 않아 가져오기 프로세스가 취소되었습니다.

메서드를 XmlImportXml 사용하여 이전에 메모리에 로드된 XML 데이터를 가져옵니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하세요.