GetRequiredElementDataBinding

GetRequiredElementDataBinding(IDependable, IWorkflowForm, XmlNode, IDataBindingProvider, String, String, Object)

Возвращает элемент привязки данных из XmlNode, содержащийся в элементе по указанному пути. Если элемент отсутствует, будет возвращено исключение.

public static IDataBinding GetRequiredElementDataBinding(
    IDependable parent,
    IWorkflowForm form,
    XmlNode node,
    IDataBindingProvider dataBindingProvider,
    string path,
    string name,
    object targetObject)

Параметры

parent IDependable Родительский объект.

form IWorkflowForm Форма.

node System.Xml.XmlNode Узел XmlNode, содержащий нужный элемент.

dataBindingProvider IDataBindingProvider Привязка элемента.

path System.String Путь до нужного элемента.

name System.String Имя объекта, в котором происходит получение значения.

targetObject System.Object Класс объекта, в котором происходит получение значения.

Возвращает

IDataBinding Возвращает ссылку.

Исключения

InvalidXmlException Если в описании узла node отсутствует элемент по пути path.

GetRequiredElementDataBinding(IDependable, IWorkflowForm, XmlNode, IDataBindingProvider, String, String, Object, String)

Возвращает элемент привязки данных из XmlNode, содержащийся в элементе по указанному пути. Если элемент отсутствует, будет возвращено исключение, сообщение которого будет дополнено переданным текстом.

public static IDataBinding GetRequiredElementDataBinding(
    IDependable parent,
    IWorkflowForm form,
    XmlNode node,
    IDataBindingProvider dataBindingProvider,
    string path,
    string name,
    object targetObject,
    string additionalMessage)

Параметры

parent IDependable Родительский объект.

form IWorkflowForm Форма.

node System.Xml.XmlNode Узел XmlNode, содержащий нужный элемент.

dataBindingProvider IDataBindingProvider Привязка элемента.

path System.String Путь до нужного элемента.

name System.String Имя объекта, в котором происходит получение значения.

targetObject System.Object Класс объекта, в котором происходит получение значения.

additionalMessage System.String Дополнительное сообщение, которое будет добавлено в текст исключения.

Возвращает

IDataBinding Возвращает ссылку.

Исключения

InvalidXmlException Если в описании узла node отсутствует элемент по пути path.

Примечания

Вы можете использовать этот метод, чтобы дополнить текст сообщения об ошибке информацией, раскрывающей суть обязательного элемента. Таким образом, сообщения об ошибках будут полными и заменять документацию.

Примеры

В следующем примере извлекается значение тэга <Text>, вложенного в тэг <SettingsSqlQuery>:

Описание команды типа MyCommand в xml-файле: