IDataObject.GetData Метод

Определение

Получает данные, связанные с заданным форматом.Retrieves the data associated with the specified data format.

Перегрузки

GetData(String)

Получает данные, связанные с заданным форматом.Retrieves the data associated with the specified data format.

GetData(Type)

Получает данные, связанные с заданным форматом типа класса.Retrieves the data associated with the specified class type format.

GetData(String, Boolean)

Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(String)

Получает данные, связанные с заданным форматом.Retrieves the data associated with the specified data format.

public:
 System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
abstract member GetData : string -> obj
Public Function GetData (format As String) As Object

Параметры

format
String

Формат извлекаемых данных.The format of the data to retrieve. Сведения о предварительно определенных форматах см. в разделе DataFormats.See DataFormats for predefined formats.

Возвращаемое значение

Object

Данные, связанные с заданным форматом, или значение null.The data associated with the specified format, or null.

Примеры

В этом примере используется DataObject класс, который реализует, IDataObject, чтобы продемонстрировать использование GetData метода.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. Метод используется для получения данных, хранящихся в myDataObject , которые связаны с Text форматом.The method is used to retrieve the data stored in myDataObject, which is associated with the Text format. В этом примере предполагается, что вы уже создали Form именованный объект Form1 и TextBox именованный объект textBox1 .The example assumes that you have already created a Form named Form1 and a TextBox named textBox1.

private:
   void GetData1()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }
private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}
Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Комментарии

Если этот метод не может найти данные в указанном формате, он пытается преобразовать данные в формат.If this method cannot find data in the specified format, it attempts to convert the data to the format. Если данные не могут быть преобразованы в указанный формат, этот метод возвращает значение null .If the data cannot be converted to the specified format, this method returns null.

Чтобы определить, связаны ли данные с или их можно преобразовать в формат, вызовите GetDataPresent перед вызовом метода GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Вызовите метод GetFormats , чтобы получить список допустимых форматов для данных, хранящихся в этом экземпляре.Call GetFormats for a list of valid formats for the data stored in this instance.

Примечание

Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.For example, data stored as Unicode can be converted to text.

Реализацию этого метода см. в разделе DataObject.GetData .For an implementation of this method, see DataObject.GetData.

См. также раздел

GetData(Type)

Получает данные, связанные с заданным форматом типа класса.Retrieves the data associated with the specified class type format.

public:
 System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
abstract member GetData : Type -> obj
Public Function GetData (format As Type) As Object

Параметры

format
Type

Объект Type, представляющий формат извлекаемых данных.A Type representing the format of the data to retrieve. Сведения о предварительно определенных форматах см. в разделе DataFormats.See DataFormats for predefined formats.

Возвращаемое значение

Object

Данные, связанные с заданным форматом, или значение null.The data associated with the specified format, or null.

Примеры

В этом примере используется DataObject класс, реализующий IDataObject , для демонстрации использования GetData метода.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. Метод используется для получения данных, хранящихся в myObject , которые связаны с конкретным типом myType .The method is used to retrieve the data stored in myObject, which is associated with a specific type, myType. Тип полученных данных отображается в окне сообщения.The type of the retrieved data is displayed in a message box. В этом примере предполагается, что вы уже создали Form именованный объект Form1 .The example assumes that you have already created a Form named Form1.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, to store the type of data.
      Type^ myType = myComponent->GetType();

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }
       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, to store the type of data.
           Type myType = myComponent.GetType();

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }
Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

Комментарии

Если этот метод не может найти данные в указанном формате, он пытается преобразовать данные в формат.If this method cannot find data in the specified format, it attempts to convert the data to the format. Если данные не могут быть преобразованы в указанный формат, этот метод возвращает значение null .If the data cannot be converted to the specified format, this method returns null.

Чтобы определить, связаны ли данные с или их можно преобразовать в формат, вызовите GetDataPresent перед вызовом метода GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Вызовите метод GetFormats , чтобы получить список допустимых форматов для данных, хранящихся в этом экземпляре.Call GetFormats for a list of valid formats for the data stored in this instance.

Примечание

Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.For example, data stored as Unicode can be converted to text.

Реализацию этого метода см. в разделе DataObject.GetData .For an implementation of this method, see DataObject.GetData.

См. также раздел

GetData(String, Boolean)

Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object

Параметры

format
String

Формат извлекаемых данных.The format of the data to retrieve. Сведения о предварительно определенных форматах см. в разделе DataFormats.See DataFormats for predefined formats.

autoConvert
Boolean

Значение true, если данные необходимо преобразовать в указанный формат, и значение false в противном случае.true to convert the data to the specified format; otherwise, false.

Возвращаемое значение

Object

Данные, связанные с заданным форматом, или значение null.The data associated with the specified format, or null.

Примеры

В этом примере используется DataObject класс, реализующий IDataObject , для демонстрации использования GetData метода.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. В примере извлекаются данные, хранящиеся в DataObject , с помощью autoConvert параметра указывается, следует ли преобразовывать формат данных.The example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether or not to convert the data format. Сначала myDataObject создается с текстовыми данными.First, myDataObject is created with text data. Затем пример пытается дважды получить данные.Then the example tries twice to retrieve the data. В первой пробной версии она задает формат в виде строки и задает autoConvert для параметра значение false .In the first trial, it specifies its format as a string and sets the autoConvert parameter to false. Эта пробная версия завершается ошибкой, и результат отображается в окне сообщения с меткой "сообщение #1".This trial fails, and the result is displayed in a message box labeled "Message #1." Во второй пробной версии в примере извлекаются те же данные с autoConvert параметром, имеющим значение true .In the second trial, the example retrieves the same data with the autoConvert parameter set to true. Эта пробная версия прошла удачно, и результат отображается в окне сообщения с меткой "сообщение #2".This trial succeeds, and the result is displayed in a message box labeled "Message #2." В этом примере предполагается, что вы создали Form именованный объект Form1 .The example assumes that you have created a Form named Form1.

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }
       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }
Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

Комментарии

Если autoConvert параметр имеет значение true и этот метод не может найти данные в указанном формате, он пытается преобразовать данные в формат.If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. Если данные не могут быть преобразованы в указанный формат или если данные были сохранены с autoConvert параметром, для которого задано значение false , этот метод возвращает значение null .If the data cannot be converted to the specified format, or if the data was stored with the autoConvert parameter set to false, this method returns null.

Если autoConvert параметр имеет значение false , этот метод возвращает данные в указанном формате или значение, null Если данные в этом формате не могут быть найдены.If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

Чтобы определить, связаны ли данные с или их можно преобразовать в формат, вызовите GetDataPresent перед вызовом метода GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Вызовите метод GetFormats , чтобы получить список допустимых форматов для данных, хранящихся в этом экземпляре.Call GetFormats for a list of valid formats for the data stored in this instance.

Примечание

Данные могут быть преобразованы в другой формат, если они были сохранены с указанием того, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.For example, data stored as Unicode can be converted to text.

Реализацию этого метода см. в разделе DataObject.GetData .For an implementation of this method, see DataObject.GetData.

См. также раздел

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