DataStoreDataExtensions.ImportXml(this IDataStoreBase dataStore, string text, DwBuffer dwbuffer, int startRow) Method

.NET Standard 2.x

Inserts data from an XML string into the specified buffer of DataStore. You can specify the starting position in the XML array. Data before the starting position will not be imported into the DataStore.

Namespace: DWNet.Data

Assembly: DWNet.Data.dll

Syntax

  public static int ImportXml(this IDataStoreBase dataStore, string text, DwBuffer dwbuffer, int startRow);

Parameters

text System.String

A string specifying the XML data.

The XML string must comply with the plain-format XML or DataWindow XML.

dwbuffer DWNet.Data.DwBuffer

The specified buffer of the DataStore.

A value of the DwBuffer enumerated datatype identifying the DataWindow buffer into which you want to import the data.

For plain-format XML: Imports the XML data to the specified buffer.

For DataWindow XML: Imports data from the specified buffer from the XML string to the corresponding buffer.

startRow System.Int32

The zero-based number of the first row in the XML array that you want to import. If it is negative, 0 is used.

Returns

System.Int32

Returns the number of rows that were imported if it succeeds.

Examples

The following code example demonstrates how to import records starting from the first row, from an XML string to a DataStore.

using DWNet.Data;
using System;

namespace Appeon.ApiDoc.DataStoreDataExtensionsExamples
{
    public class ImportXmlExample
    {
        private readonly SchoolContext _context;

        public ImportXmlExample(SchoolContext dataContext)
        {
            // Sets the data context
            _context = dataContext;
        }

        public void Example3()
        {
            // Instantiates a DataStore object with datawindow: d_department.
            var datastore = new DataStore("d_department", _context);
			
			// Gets the XML string to be imported.
            string importXml = GetImportXml();

            // Starting from the first row, imports data from the XML string to the datastore.
            datastore.ImportXml(importXml, DwBuffer.Primary, 0);

            Console.WriteLine("Rowcount: {0}", datastore.RowCount);

            for (int row = 0, rowcount = datastore.RowCount; row < rowcount; row++)
            {
                Console.WriteLine("DepartmentID: {0}; Name: {1}; Budget: {2}",
                                  datastore.GetItem<int>(row, "departmentid"),
                                  datastore.GetItem<string>(row, "name"),
                                  datastore.GetItem<decimal>(row, "budget"));
            }

            /*This code produces the following output:

            Rowcount: 2
            DepartmentID: 1; Name: Engineering; Budget: 220000.0000
            DepartmentID: 2; Name: English; Budget: 120000.0000
           */
        }
    }
}

Example Refer To

Model Class: D_Department
DataWindow File: d_department

Applies to

.NET Standard

2.x