Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe DataFormats

Fornece static, nomes de formatos pré-definidos do Clipboard . Usá-los para identificar o formato dos dados armazenados em um IDataObject.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public class DataFormats

The IDataObject e DataObject classes também usar o static lista de formato para determinar o tipo de dados que são recuperados do sistema Clipboard, ou que é transferido em uma operação de do tipo arrastar e soltar.

The GetFormat método permite que você:

  • Obtenha um predefinidos DataFormats.Format objeto para um formato de nome ou número de ID.

  • Adicionar um novo emparelhar de número de ID do nome do formato a ostatic Listar nessa classe e para registrar o formato no registro do Windows sistema autônomo um Clipboard formato quando você passar o nome de formato.

Você pode obter o Id formato de número ou Name da propriedade apropriada das DataFormats.Format instância.

O exemplo de código a seguir cria um novo formato de dados chamado myFormat. O código cria um MyNewObject que armazena em um DataObject. The DataObject é copiado para o Clipboard.

Em seguida, a DataObject é recuperada das Clipboard e o MyNewObject é recuperado. O valor de MyNewObject é impresso em uma caixa de texto. Esse código requer que textBox1 foi criado e colocado em um formulário.

using System;
using System.Windows.Forms;

publicclass MyClass : Form {
    protected TextBox textBox1;

    publicvoid MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");

       /* Creates a new object and stores it in a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name, myObject);

       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);

       // Performs some processing steps.// Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();

       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);

       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }

 // Creates a new type.
 [Serializable]
 publicclass MyNewObject : Object {
    private string myValue;

    // Creates a default constructor for the class.public MyNewObject() {
       myValue = "This is the value of the class";
    }

    // Creates a property to retrieve or set the value.public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }




import System.*;
import System.Windows.Forms.*;

public class MyClass extends Form
{
    protected TextBox textBox1;

    public void MyClipboardMethod()
    {
        // Creates a new data format.
        DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
        /*  Creates a new object and stores it in a DataObject using myFormat 
            as the type of format. 
         */
        MyNewObject myObject = new MyNewObject();
        DataObject myDataObject = new DataObject(myFormat.get_Name(),myObject);

        // Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject);

        // Performs some processing steps.
        // Retrieves the data from the clipboard.
        IDataObject myRetrievedObject = Clipboard.GetDataObject();

        // Converts the IDataObject type to MyNewObject type. 
        MyNewObject myDereferencedObject = 
            (MyNewObject)(myRetrievedObject.GetData(myFormat.get_Name()));

        // Prints the value of the Object in a textBox.
        textBox1.set_Text(myDereferencedObject.get_MyObjectValue());
    } //MyClipboardMethod
} //MyClass

// Creates a new type.
/** @attribute Serializable()
 */
public class MyNewObject extends Object
{
    private String myValue;
    // Creates a default constructor for the class.
    public MyNewObject()
    {
        myValue = "This is the value of the class";
    } //MyNewObject

    // Creates a property to retrieve or set the value.
    /** @property 
     */
    public String get_MyObjectValue()
    {
        return myValue;
    } //get_MyObjectValue

    /** @property 
     */
    public void set_MyObjectValue(String value)
    {
        myValue = value;
    } //set_MyObjectValue
} //MyNewObject


import System;
import System.Windows.Forms;

public class MyClass extends Form {
    protected var textBox1 : TextBox;

    public function MyClipboardMethod() {
       // Create a new data format.
       var myFormat : DataFormats.Format = DataFormats.GetFormat("myFormat");

       /* Create a new object and store it in a DataObject import the myFormat 
        * as the type of format. */
       var myObject : MyNewObject = new MyNewObject();
       var myDataObject : DataObject = new DataObject("myFormat", myObject);

       // Copy myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);

       // Perform some processing steps.

       // Retrieve the data from the clipboard.
       var myRetrievedObject : IDataObject = Clipboard.GetDataObject();

       // Convert the IDataObject type to MyNewObject type. 
       var myDereferencedObject : MyNewObject = MyNewObject(myRetrievedObject.GetData("myFormat"));

       // Print the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }

 // Create a new type.
Serializable public class MyNewObject extends Object {
    private var myValue : String;

    // Create a default constructor for the class.
    public function MyNewObject() {
       myValue = "This is the value of the class";
    }

    // Create a property to retrieve or set the value.
    public function get MyObjectValue() : String {
          return myValue;
    }

    public function set MyObjectValue(value : String) {
          myValue = value;
    }
 }



System.Object
  System.Windows.Forms.DataFormats

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatível com: 3.5, 2.0
Mostrar: