IDataObject.GetDataPresent Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Determina se i dati memorizzati nell'istanza sono associati al formato specificato.

Overload

GetDataPresent(String)	Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.
GetDataPresent(Type)	Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.
GetDataPresent(String, Boolean)	Determina se i dati memorizzati nell'istanza sono associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.

GetDataPresent(String)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.

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

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parametri

format: String

Il formato da ricercare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Boolean

true se i dati memorizzati nell'istanza sono associati al formato specificato o possono essere convertiti in tale formato; in caso contrario, false.

Esempio

In questo esempio viene usata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetDataPresent metodo . Prima di tutto, crea un oggetto dati usando una stringa e il Text formato. Verifica quindi che i dati siano presenti nel Text formato e visualizzino i risultati in una finestra di messaggio. L'esempio presuppone che sia stato creato un Form oggetto denominato Form1.

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

      // Checks whether the data is present in the Text format and displays the result.
      if ( myDataObject->GetDataPresent( DataFormats::Text ) )
            MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
      else
            MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
   }

       private void TestDataObject() 
       {
           // Creates a new data object using a string and the Text format.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Checks whether the data is present in the Text format and displays the result.
           if (myDataObject.GetDataPresent(DataFormats.Text))
               MessageBox.Show("The stored data is in the Text format." , "Test Result");
           else
               MessageBox.Show("The stored data is not in the Text format.", "Test Result");
       }

Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub

Commenti

Chiamare questo metodo per determinare se in questo DataObject formato esiste un formato prima di chiamare GetData. Chiamare GetFormats i formati disponibili in questa istanza.

Nota

I dati possono essere convertiti in un altro formato se è stato archiviato specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

Per un'implementazione di questo metodo, vedere DataObject.GetDataPresent.

Vedi anche

Si applica a

GetDataPresent(Type)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parametri

format: Type

Oggetto Type che rappresenta il formato da ricercare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Boolean

true se i dati memorizzati nell'istanza sono associati o possono essere convertiti nel formato specificato; in caso contrario, false.

Esempio

In questo esempio viene usata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetDataPresent metodo . Prima di tutto, crea un componente () e lo archivia in un oggetto dati (myComponentmyDataObject). Verifica quindi se i dati specificati vengono archiviati in myDataObject. Se il test valuta true, visualizza il risultato in una casella di messaggio e visualizza il tipo di dati in una casella di testo. In questo esempio si presuppone che sia già stato creato un Form nome Form1 e un TextBox denominato textBox1.

private:
   void GetDataPresent2()
   {
      // 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();

      // Checks whether the specified data type exists in the object.
      if ( myDataObject->GetDataPresent( myType ) )
      {
         MessageBox::Show( "The specified data is stored in the data object." );

         // Displays the type of data.
         textBox1->Text = "The data type is " + myDataObject->GetData( myType )->GetType()->Name + ".";
      }
      else
            MessageBox::Show( "The specified data is not stored in the data object." );
   }

       private void GetDataPresent2() 
       {
           // 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();

           // Checks whether the specified data type exists in the object.
           if (myDataObject.GetDataPresent(myType))
           {
               MessageBox.Show("The specified data is stored in the data object.");
               // Displays the type of data.
               textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
           }
           else
           {
               MessageBox.Show("The specified data is not stored in the data object.");
           }
       }

Private Sub GetDataPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New System.ComponentModel.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()

    ' Checks whether the specified data type exists in the object.
    If myDataObject.GetDataPresent(myType) Then
        MessageBox.Show("The specified data is stored in the data object.")
        ' Displays the type of data.
        TextBox1.Text = "The data type is " & myDataObject.GetData(myType).GetType().Name & "."
    Else
        MessageBox.Show("The specified data is not stored in the data object.")
    End If
End Sub

Commenti

Chiamare questo metodo per determinare se in questo DataObject formato esiste un formato prima di chiamare GetData. Chiamare GetFormats i formati disponibili in questa istanza.

Nota

Per un'implementazione di questo metodo, vedere DataObject.GetDataPresent.

Vedi anche

Si applica a

GetDataPresent(String, Boolean)

Determina se i dati memorizzati nell'istanza sono associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.

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

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool

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

Parametri

format: String

Il formato da ricercare. Per i formati predefiniti, vedere DataFormats.

autoConvert: Boolean

true per determinare se i dati memorizzati in questa istanza possono essere convertiti nel formato specificato; false per verificare se i dati sono nel formato specificato.

Restituisce

Boolean

true se i dati sono nel formato specificato o possono essere convertiti in tale formato; in caso contrario, false.

Esempio

In questo esempio viene usata la DataObject classe , che implementa IDataObject, per illustrare l'uso del GetDataPresent metodo . In primo luogo, crea un oggetto dati (myDataObject) usando una stringa e il Text formato. Esegue quindi una query sull'oggetto per i dati associati al Text formato, con il autoConvert parametro impostato su false. Questa versione di valutazione ha esito negativo e il risultato viene visualizzato in una finestra di messaggio etichettata "Message #1". Nella seconda versione di valutazione imposta il autoConvert parametro su true. Questa versione di valutazione ha esito positivo e il risultato viene visualizzato in una finestra di messaggio etichettata "Message #2". L'esempio presuppone che sia stato creato un Form oggetto denominato Form1.

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

      // Checks whether the string can be displayed with autoConvert equal to false.
      if ( myDataObject->GetDataPresent( "System::String", false ) )
            MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
      else
            MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );

      // Displays the string with autoConvert equal to true.
      MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
   }

       private void GetDataPresent3() 
       {
           // Creates a new data object using a string and the Text format.
           DataObject myDataObject = new DataObject(DataFormats.Text, "My String");

           // Checks whether the string can be displayed with autoConvert equal to false.
           if(myDataObject.GetDataPresent("System.String", false)) 
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
           else
               MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");

           // Displays the string with autoConvert equal to true.
           MessageBox.Show("Now that autoConvert is true, you can convert " + 
               myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
       }

Private Sub GetDataPresent3()
    ' Creates a new data object using a string and the Text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "My String")

    ' Checks whether the string can be displayed with autoConvert equal to false.
    If myDataObject.GetDataPresent("System.String", False) Then
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
    Else
        MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
    End If
    ' Displays the string with autoConvert equal to true.
    MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
         True).ToString() + " to string format."), "Message #2")

End Sub

Commenti

Chiamare questo metodo per determinare se in questo DataObject formato esiste un formato prima di chiamare GetData. Chiamare GetFormats i formati disponibili in questa istanza.

Questo metodo restituisce true quando:

Il autoConvert parametro è true e i dati sono in un formato che può essere convertito nel formato appropriato.
Il autoConvert parametro è false e i dati sono nel formato appropriato.

Questo metodo restituisce false quando:

Il autoConvert parametro è true e questo metodo non riesce a trovare i dati nel formato specificato e non può convertire i dati nel formato specificato oppure i dati sono stati archiviati con autoConvert impostato su false.
Il parametro è falsee i autoConvert dati non esistono in questa istanza nel formato specificato.

Nota

Per un'implementazione di questo metodo, vedere DataObject.GetDataPresent.

Vedi anche

Si applica a

IDataObject.GetDataPresent Metodo

Definizione

Overload

GetDataPresent(String)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

GetDataPresent(Type)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

GetDataPresent(String, Boolean)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive