DataObject.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 in questa classe DataObject sono associati al formato specificato.

Overload

GetDataPresent(String)	Determina se i dati memorizzati in questa classe DataObject sono associati al formato specificato o possono essere convertiti in tale formato.
GetDataPresent(Type)	Determina se i dati memorizzati in questa classe DataObject sono associati al formato specificato o possono essere convertiti in tale formato.
GetDataPresent(String, Boolean)	Determina se questa classe DataObject contiene dati nel formato specificato o, facoltativamente, contiene i dati che possono essere convertiti nel formato specificato.

GetDataPresent(String)

Determina se i dati memorizzati in questa classe DataObject sono associati al formato specificato o possono essere convertiti in tale formato.

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

Parametri

format: String

Formato da verificare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Boolean

true se i dati memorizzati in questa classe DataObject sono associati o possono essere convertiti nel formato specificato; in caso contrario, false.

Implementazioni

GetDataPresent(String)

Esempio

Nell'esempio di codice seguente viene determinato se i dati attualmente archiviati in questo DataObject oggetto sono associati o possono essere convertiti in un formato specificato. Un nuovo DataObject oggetto viene inizializzato con una stringa e il formato associato specificato come testo.

Gli esempi stampano quindi se i dati di testo sono presenti in DataObject. Questo codice richiede che textBox1 sia stato creato.

Commenti

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

Nota

I dati possono essere convertiti in un altro formato se sono stati archiviati 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.

Nota

Se non è possibile recuperare dati, non verrà generata alcuna eccezione. Verrà invece false restituito .

Vedi anche

Si applica a

GetDataPresent(Type)

Determina se i dati memorizzati in questa classe DataObject sono associati al formato specificato o possono essere convertiti in tale formato.

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

Parametri

format: Type

Type che rappresenta il formato da ricercare.

Restituisce

Boolean

true se i dati memorizzati in questa classe DataObject sono associati o possono essere convertiti nel formato specificato; in caso contrario, false.

Implementazioni

GetDataPresent(Type)

Esempio

Nell'esempio di codice seguente viene determinato se i dati del tipo specificato esistono in un DataObjectoggetto o se i dati possono essere convertiti nel tipo specificato. Il risultato viene visualizzato in una casella di testo. Il codice richiede che textBox1 sia stato creato.

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

Commenti

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

Nota

Se non è possibile recuperare dati, non verrà generata alcuna eccezione. Verrà invece false restituito .

Vedi anche

Si applica a

GetDataPresent(String, Boolean)

Determina se questa classe DataObject contiene dati nel formato specificato o, facoltativamente, contiene i dati che possono essere convertiti nel formato specificato.

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

Parametri

format: String

Formato da verificare. Per i formati predefiniti, vedere DataFormats.

autoConvert: Boolean

true per determinare se i dati memorizzati in questa classe DataObject 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.

Implementazioni

GetDataPresent(String, Boolean)

Esempio

Nell'esempio di codice seguente viene determinato se i dati attualmente archiviati in DataObject sono associati a un formato specificato. Innanzitutto, un nuovo DataObject viene inizializzato con una stringa, specificandone il formato come testo.

DataObject Viene quindi eseguita una query per i dati associati al formato di testo, specificando il autoConvert parametro come false. Il risultato di questa query viene stampato in una casella di testo.

DataObject Viene quindi eseguita una query per i dati associati al formato stringa, specificando il autoConvert parametro come true. I risultati vengono stampati nella casella di testo. Questo codice richiede che textBox1 sia stato creato.

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

Commenti

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

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 dati nel formato specificato e non può convertire i dati nel formato specificato oppure i dati sono stati archiviati con la conversione automatica impostata su false.
Il autoConvert parametro è false e i dati non esistono nel DataObject formato specificato.

Nota

Se non è possibile recuperare dati, non verrà generata alcuna eccezione. Verrà invece false restituito .

Vedi anche

Si applica a

Condividi tramite

DataObject.GetDataPresent Metodo

Definizione

Overload

GetDataPresent(String)

Parametri

Restituisce

Implementazioni

Esempio

Commenti

Vedi anche

Si applica a

GetDataPresent(Type)

Parametri

Restituisce

Implementazioni

Esempio

Commenti

Vedi anche

Si applica a

GetDataPresent(String, Boolean)

Parametri

Restituisce

Implementazioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive