CodeTypeDeclaration.IsPartial Propriedade

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 de Propriedade

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. A predefinição é false.

Exemplos

Este exemplo demonstra o uso de a CodeTypeDeclaration para fornecer uma implementação de classe através de múltiplas declarações. O exemplo constrói a declaração inicial de declaração de classe e define a IsPartial propriedade para true.

            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. Este método constrói uma nova declaração de tipo para a classe existente e define a IsPartial propriedade como true. O compilador combina as duas declarações parciais de tipos para a implementação completa da classe.

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)

Observações

Pode construir uma implementação de classe ou estrutura numa única declaração completa, ou distribuir a implementação por várias declarações. As implementações são normalmente fornecidas numa única declaração de tipo completa. Neste caso, defina a propriedade de declaração IsPartial de tipo para false, o que indica que a declaração de tipo representa todos os detalhes da implementação da classe ou estrutura.

Uma declaração parcial de tipo facilita a construção de diferentes partes de uma implementação de classe ou estrutura em diferentes módulos da sua aplicação. As declarações parciais de tipo podem ser armazenadas num único ficheiro fonte, ou espalhadas por múltiplos ficheiros fonte que são eventualmente compilados para formar a implementação combinada de tipos.

A linguagem C# suporta declarações parciais de tipos de classes e estruturas através da partial palavra-chave. Visual Basic suporta declarações parciais de tipos de classes e estruturas com a palavra-chave Partial. Nem todos os geradores de código suportam declarações parciais de tipos, por isso deve testar este suporte chamando o Supports método com a flag PartialTypes.

Ao fornecer uma implementação de classe ou estrutura através de múltiplas declarações, defina a IsPartial propriedade para true para a declaração inicial e para todas as declarações suplementares. A declaração inicial deve especificar completamente a assinatura do tipo, incluindo modificadores de acesso, tipos herdados e interfaces implementadas. As declarações suplementares não precisam de reespecificar a assinatura do tipo. Um erro do compilador normalmente resulta se redefinir a assinatura de tipo numa declaração suplementar.

O Visual Studio 2005 utiliza tipos parciais para separar o código gerado pelo utilizador do código de designer. Em Visual Basic Windows projetos de aplicação, o código de utilizador é colocado numa classe parcial que não é qualificada pela palavra-chave Partial; o código fornecido pelo designer aparece na classe parcial que tem a palavra-chave Partial. Em C#, tanto o código de utilizador como o código de designer aparecem em classes parciais identificadas pela partial palavra-chave.

Ver também

• PartialTypes