CodeTypeDeclaration.IsPartial Propriedade

Definição

Namespace:

System.CodeDom

Assembly:

System.CodeDom.dll

Pacote:

System.CodeDom v8.0.0

Origem:

CodeTypeDeclaration.cs

Obtém ou define um valor que indica se a declaração de tipo é completa ou parcial.

public:
 property bool IsPartial { bool get(); void set(bool value); };

public bool IsPartial { get; set; }

member this.IsPartial : bool with get, set

Public Property IsPartial As Boolean

Valor da propriedade

Boolean

true se a declaração de classe ou estrutura for uma representação parcial da implementação; false se a declaração for uma implementação completa da classe ou estrutura. O padrão é false.

Exemplos

Este exemplo demonstra como usar um CodeTypeDeclaration para fornecer uma implementação de classe em várias declarações. O exemplo cria a instrução de declaração de classe inicial e define a IsPartial propriedade como true.

CodeTypeDeclaration^ baseClass = gcnew CodeTypeDeclaration( "DocumentProperties" );
baseClass->IsPartial = true;
baseClass->IsClass = true;
baseClass->Attributes = MemberAttributes::Public;
baseClass->BaseTypes->Add( gcnew CodeTypeReference( System::Object::typeid ) );

// Add the DocumentProperties class to the namespace.
sampleSpace->Types->Add( baseClass );

            CodeTypeDeclaration baseClass = new CodeTypeDeclaration("DocumentProperties");
            baseClass.IsPartial = true;
            baseClass.IsClass = true;
            baseClass.Attributes = MemberAttributes.Public;
            baseClass.BaseTypes.Add(new CodeTypeReference(typeof(System.Object
)));

            // Add the DocumentProperties class to the namespace.
            sampleSpace.Types.Add(baseClass);

Dim baseClass As CodeTypeDeclaration = New CodeTypeDeclaration("DocumentProperties")
baseClass.IsPartial = True
baseClass.IsClass = True
baseClass.Attributes = MemberAttributes.Public
baseClass.BaseTypes.Add(New CodeTypeReference(GetType(System.Object)))

' Add the DocumentProperties class to the namespace.
sampleSpace.Types.Add(baseClass)

Um método diferente no exemplo estende a implementação da classe. Esse método cria uma nova instrução de declaração de tipo para a classe existente e define a IsPartial propriedade como true. O compilador combina as duas declarações de tipo parcial para a implementação completa da classe.

CodeTypeDeclaration^ baseClass = gcnew CodeTypeDeclaration( "DocumentProperties" );
baseClass->IsPartial = true;
baseClass->IsClass = true;
baseClass->Attributes = MemberAttributes::Public;

// Extend the DocumentProperties class in the unit namespace.
( *docPropUnit)->Namespaces[ 0 ]->Types->Add( baseClass );

CodeTypeDeclaration baseClass = new CodeTypeDeclaration("DocumentProperties");
baseClass.IsPartial = true;
baseClass.IsClass = true;
baseClass.Attributes = MemberAttributes.Public;

// Extend the DocumentProperties class in the unit namespace.
docPropUnit.Namespaces[0].Types.Add(baseClass);

Dim baseClass As CodeTypeDeclaration = New CodeTypeDeclaration("DocumentProperties")
baseClass.IsPartial = True
baseClass.IsClass = True
baseClass.Attributes = MemberAttributes.Public

' Extend the DocumentProperties class in the unit namespace.
docPropUnit.Namespaces(0).Types.Add(baseClass)

Comentários

Você pode criar uma implementação de classe ou estrutura em uma declaração completa ou distribuir a implementação entre várias declarações. As implementações geralmente são fornecidas em uma declaração de tipo completa. Nesse caso, defina a propriedade de declaração IsPartial de tipo como false, que indica que a declaração de tipo representa todos os detalhes para a implementação de classe ou estrutura.

Uma declaração de tipo parcial facilita a criação de diferentes partes de uma implementação de classe ou estrutura em diferentes módulos do aplicativo. As declarações de tipo parcial podem ser armazenadas em um arquivo de origem ou distribuídas entre vários arquivos de origem que eventualmente são compilados juntos para formar a implementação de tipo combinada.

A linguagem C# dá suporte a declarações de tipo parcial de classes e estruturas por meio do partial palavra-chave. O Visual Basic dá suporte a declarações de tipo parcial de classes e estruturas com o Partial palavra-chave. Nem todos os geradores de código dão suporte a declarações de tipo parcial, portanto, você deve testar esse suporte chamando o Supports método com o sinalizador PartialTypes.

Observação

Há suporte para declarações de tipo parcial para classes e estruturas. Se você especificar uma declaração de tipo parcial para uma enumeração ou interface, o código gerado produzirá erros do compilador.

Ao fornecer uma implementação de classe ou estrutura em várias declarações, defina a IsPartial propriedade true como para a declaração inicial e todas as declarações complementares. A declaração inicial deve especificar totalmente a assinatura de tipo, incluindo modificadores de acesso, tipos herdados e interfaces implementadas. As declarações suplementares não precisam especificar novamente a assinatura de tipo. Um erro do compilador normalmente resulta se você redefinir a assinatura de tipo em uma declaração suplementar.

O Visual Studio 2005 usa tipos parciais para separar o código gerado pelo usuário do código do designer. Em projetos de Aplicativo do Windows do Visual Basic, o código do usuário é colocado em uma classe parcial que não é qualificada pelo Partial palavra-chave; o código fornecido pelo designer aparece na classe parcial que tem o Partial palavra-chave. Em C#, o código do usuário e o código do designer aparecem em classes parciais identificadas pelo partial palavra-chave.

Confira também

• PartialTypes