DataObject.GetDataPresent Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Перегрузки

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

GetDataPresent(String, Boolean)

Исходный код:

DataObject.cs

Определяет, содержит ли он 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 формате в указанном формате.

Note

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

Note

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

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

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

GetDataPresent(String)

Исходный код:

DataObject.cs

Определяет, связаны ли данные в этом 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разделе.

Note

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

Note

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

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

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

GetDataPresent(Type)

Исходный код:

DataObject.cs

Определяет, связаны ли данные в этом 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разделе.

Note

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

Note

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

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

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