DataObject.GetDataPresent Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Определяет, связаны ли хранимые в этом экземпляре DataObject данные с указанным форматом.

Перегрузки

GetDataPresent(String)	Определяет, связаны ли хранимые в этом экземпляре DataObject данные с указанным форматом и возможно ли их преобразование в этот формат.
GetDataPresent(Type)	Определяет, связаны ли хранимые в этом экземпляре DataObject данные с указанным форматом и возможно ли их преобразование в этот формат.
GetDataPresent(String, Boolean)	Определяет, содержит ли этот экземпляр DataObject данные в указанном формате или данные, которые можно преобразовать в этот формат.

GetDataPresent(String)

Определяет, связаны ли хранимые в этом экземпляре DataObject данные с указанным форматом и возможно ли их преобразование в этот формат.

public:
 virtual bool GetDataPresent(System::String ^ format);

public virtual bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Overridable Function GetDataPresent (format As String) As Boolean

Параметры

format

String

Проверяемый формат. Сведения о предварительно определенных форматах см. в разделе DataFormats.

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

Boolean

Значение true, если хранящиеся в данном экземпляре DataObject данные связаны с указанным форматом или могут быть преобразованы в него, и значение false в противном случае.

Реализации

GetDataPresent(String)

Примеры

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

Затем в примерах показано, существуют ли текстовые DataObjectданные в . Для этого кода требуется, чтобы textBox1 он был создан.

Комментарии

Вызовите этот метод, чтобы определить, существует ли формат перед вызовом GetDataметода . Вызовите GetFormats форматы, доступные в этом .DataObject

Примечание

Данные можно преобразовать в другой формат, если они были сохранены, указывая, что преобразование разрешено, и если запрошенный формат совместим с хранимым форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.

Примечание

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

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

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• DataFormats
• GetFormats(Boolean)

GetDataPresent(Type)

Определяет, связаны ли хранимые в этом экземпляре DataObject данные с указанным форматом и возможно ли их преобразование в этот формат.

public:
 virtual bool GetDataPresent(Type ^ format);

public virtual bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Overridable Function GetDataPresent (format As Type) As Boolean

Параметры

format

Type

Объект Type, представляющий проверяемый формат.

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

Boolean

Значение true, если хранящиеся в данном экземпляре DataObject данные связаны с указанным форматом или могут быть преобразованы в него, и значение false в противном случае.

Реализации

GetDataPresent(Type)

Примеры

В следующем примере кода определяется, существуют ли данные указанного типа в DataObjectили же данные можно преобразовать в указанный тип. Результат отображается в текстовом поле. Для кода требуется, чтобы textBox1 он был создан.

private:
   void GetIfPresent2()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );
      
      // Creates a type to store the type of data.
      Type^ myType = myComponent->GetType();
      
      // Determines if the DataObject has data of the Type format.
      textBox1->Text = String::Concat( "Is the specified data type available ",
         "in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
      
      // Retrieves the data using its type format, and displays the type.
      Object^ myObject = myDataObject->GetData( myType );
      textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
         "in the DataObject is: ", myObject->GetType()->Name );
   }

private void GetIfPresent2() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object and assigns it the component.
    DataObject myDataObject = new DataObject(myComponent);
 
    // Creates a type to store the type of data.
    Type myType = myComponent.GetType();
 
    // Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " +
       "DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
 
    // Retrieves the data using its type format, and displays the type.
    Object myObject = myDataObject.GetData(myType);
    textBox1.Text += "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
 }

Private Sub GetIfPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)
    
    ' Creates a type to store the type of data.
    Dim myType As Type = myComponent.GetType()
    
    ' Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
        myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
    
    ' Retrieves the data using its type format, and displays the type.
    Dim myObject As Object = myDataObject.GetData(myType)
    textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub

Комментарии

Вызовите этот метод, чтобы определить, существует ли формат перед вызовом GetDataметода . Вызовите GetFormats форматы, доступные в этом .DataObject

Примечание

Данные можно преобразовать в другой формат, если они были сохранены, указывая, что преобразование разрешено, и если запрошенный формат совместим с хранимым форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.

Примечание

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

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

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• Type
• DataFormats
• GetFormats(Boolean)

GetDataPresent(String, Boolean)

Определяет, содержит ли этот экземпляр DataObject данные в указанном формате или данные, которые можно преобразовать в этот формат.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);

public virtual bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

Public Overridable Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Параметры

format

String

Проверяемый формат. Сведения о предварительно определенных форматах см. в разделе DataFormats.

autoConvert

Boolean

Значение true, если необходимо определить возможность преобразования данных, хранимых в данном экземпляре DataObject, в указанный формат, и значение false, если необходимо проверить наличие данных в указанном формате.

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

Boolean

Значение true, если данные находятся в указанном формате или могут быть в него преобразованы; в противном случае — значение false.

Реализации

GetDataPresent(String, Boolean)

Примеры

В следующем примере кода определяется, связаны ли данные, хранящиеся в объекте DataObject , с указанным форматом. Во-первых, новый DataObject объект инициализируется строкой, указывая ее формат в виде текста.

DataObject Затем запрашивается данные, связанные с текстовым форматом, с указанием autoConvert параметра как false. Результат этого запроса выводится в текстовом поле.

DataObject Затем запрашивается данные, связанные со строковым форматом, с указанием autoConvert параметра как true. Результаты отображаются в текстовом поле. Для этого кода требуется, чтобы textBox1 он был создан.

private:
   void GetIfPresent3()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetDataPresent( "System.String", false ) )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not convert data to specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat( textBox1->Text,
         "With autoconvert = true, you can convert text to string format. String is: ",
         myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetIfPresent3() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetDataPresent("System.String", false)) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not convert data to specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
       "String is: " + myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetIfPresent3()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Prints the string in a text box with autoconvert = false.
    If myDataObject.GetDataPresent("System.String", False) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
                    "String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub

Комментарии

Вызовите этот метод, чтобы определить, существует ли формат перед вызовом GetDataметода . Вызовите GetFormats форматы, доступные в этом .DataObject

Этот метод возвращает, true если:

• Параметр autoConvert имеет значение , true а данные — в формате, который можно преобразовать в соответствующий формат.

• Параметр autoConvert имеет значение , false а данные — в соответствующем формате.

Этот метод возвращает, false если:

• Параметр autoConvert имеет значение , true и этот метод не может найти данные в указанном формате, и он не может преобразовать данные в указанный формат, или данные были сохранены с автоматическим преобразованием, установленным в false.

• Параметр autoConvert имеет значение , false а данные не существуют в указанном DataObject формате.

Примечание

Данные можно преобразовать в другой формат, если они были сохранены, указав, что преобразование разрешено, и если запрошенный формат совместим с хранимым форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.

Примечание

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

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

• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• DataFormats
• GetFormats(Boolean)