InputBinding.CommandParameter Свойство

Определение

Получает или задает специфические для команды данные для конкретной команды.Gets or sets the command-specific data for a particular command.

public:
 property System::Object ^ CommandParameter { System::Object ^ get(); void set(System::Object ^ value); };
public object CommandParameter { get; set; }
member this.CommandParameter : obj with get, set
Public Property CommandParameter As Object

Значение свойства

Связанные с командой данные.The command-specific data. Значение по умолчанию — null.The default is null.

Комментарии

CommandParameter Свойство используется для передачи определенной информации команде при ее выполнении.The CommandParameter property is used to pass specific information to the command when it is executed. Тип данных определяется командой.The type of the data is defined by the command. Многие команды не предполагают параметров команды; для этих команд переданные параметры команды будут игнорироваться.Many commands do not expect command parameters; for these commands, any command parameters passed will be ignored.

Если команда, с которой связана входная привязка, имеет значение RoutedCommand, то CommandParameter входная RoutedCommand привязка передается обработчикам через ExecutedRoutedEventArgs и CanExecuteRoutedEventArgs данные события при обработке команды.If the command that an input binding is associated with is a RoutedCommand, the CommandParameter of the input binding is passed to the RoutedCommand handlers through the ExecutedRoutedEventArgs and the CanExecuteRoutedEventArgs event data when the command is processed.

Тип данных и назначение параметра команды определяются по-разному для каждой команды и могут иметь nullзначение.The data type and purpose of the command parameter are defined differently for each command and can be null. Свойства Command, CommandParameterи ICommand можно привязать к объекту, определенному для объекта. CommandTargetYou can bind the Command, CommandParameter, and CommandTarget properties to an ICommand that is defined on an object. Это позволяет определить пользовательскую команду и связать ее с введенными пользователем данными.This enables you to define a custom command and associate it with user input. Дополнительные сведения см. во втором примере в InputBindingразделе.For more information, see the second example in InputBinding.

InputBinding Класс не поддерживает использование XAML, поскольку он не предоставляет открытый конструктор без параметров (он имеет конструктор без параметров, но он защищен).The InputBinding class does not support XAML usage because it does not expose a public parameterless constructor (it has a parameterless constructor, but it is protected). Однако производные классы могут предоставлять открытый конструктор, поэтому могут устанавливать свойства, унаследованные от InputBinding использования XAML.However, derived classes can expose a public constructor and therefore, can set properties that are inherited from InputBinding with XAML usage. Два существующих InputBinding производных класса, которые могут быть созданы в XAML, и могут задавать свойства в KeyBinding XAML MouseBinding— и.Two existing InputBinding derived classes that can be instantiated in XAML and can set properties in XAML are KeyBinding and MouseBinding.

Использование атрибута XAMLXAML Attribute Usage

<inputBindingDerivedClass CommandParameter="commandParameterString"/>  

Использование элемента свойства XAMLXAML Property Element Usage

<inputBindingDerivedClass>  
  <inputBindingDerivedClass.CommandParameter>  
    <commandParameterObject/>  
  </inputBindingDerivedClass.CommandParameter>  
</inputBindingDerivedClass>  

Значения XAMLXAML Values

inputBindingDerivedClass
Производный класс InputBinding , который поддерживает синтаксис элементов объекта, KeyBinding например или MouseBinding.A derived class of InputBinding that supports object element syntax, such as KeyBinding or MouseBinding. См. заметки.See Remarks.

commandParameterString
Строка, обрабатываемая определенной командой.A string that is processed by a particular command. Строки — это общий тип, используемый для параметров команды, так как их можно легко задать в XAML.Strings are the common type used for command parameters because they can be easily set in XAML. Ожидаемый формат строки и его назначение см. в документации по определенной команде, с которой связана входная привязка.For the expected string format and its purpose, see the documentation for the particular command that the input binding is associated with. Многие команды не предполагают параметров.Many commands do not expect parameters.

commandParameterObject
Объект, обрабатываемый определенной командой.An object that is processed by a particular command. Все существующие WPFWPF команды используют строки.All existing WPFWPF commands use strings. Поэтому этот синтаксис элемента свойства относится только к сценариям пользовательской команды.Therefore, this property element syntax is only relevant for custom command scenarios. Для поддержки этого синтаксиса commandParameterObject объект должен также поддерживать синтаксис элемента объекта (должен иметь открытый конструктор без параметров).In order to support this syntax, the commandParameterObject object must also support object element syntax (must have a public parameterless constructor).

Применяется к