Rozszerzanie właściwości dla obiektów

Podczas rozszerzania obiektów programu .NET Framework można dodawać właściwości aliasu, właściwości kodu, właściwości notatek, właściwości skryptu i zestawy właściwości do obiektów. Kod XML definiujący te właściwości jest opisany w poniższych sekcjach.

Uwaga

Przykłady w poniższych sekcjach pochodzą z domyślnego pliku typów Types.ps1xml w katalogu instalacyjnym programu PowerShell ($PSHOME). Aby uzyskać więcej informacji, zobacz About Types.ps1xml.

Właściwości aliasu

Właściwość aliasu definiuje nową nazwę istniejącej właściwości.

W poniższym przykładzie właściwość Count jest dodawana do typu System.Array. Element AliasProperty definiuje właściwość rozszerzoną jako właściwość aliasu. Element Nazwa określa nową nazwę. A element ReferencedMemberName określa istniejącą właściwość, do którego odwołuje się alias. Można również dodać element AliasProperty do elementów członkowskich MemberSets.

<Type>
  <Name>System.Array</Name>
  <Members>
    <AliasProperty>
      <Name>Count</Name>
      <ReferencedMemberName>Length</ReferencedMemberName>
    </AliasProperty>
  </Members>
</Type>

Właściwości kodu

Właściwość kodu odwołuje się do właściwości statycznej obiektu programu .NET Framework.

W poniższym przykładzie właściwość trybu jest dodawana do typu System.IO.DirectoryInfo. Element CodeProperty definiuje właściwość rozszerzoną jako właściwość kodu. Element Name określa nazwę właściwości rozszerzonej. Element GetCodeReference definiuje metodę statyczną, do którego odwołuje się właściwość rozszerzona. Można również dodać element CodeProperty do elementów członkowskich MemberSets.

<Type>
  <Name>System.IO.DirectoryInfo</Name>
  <Members>
    <CodeProperty>
      <Name>Mode</Name>
      <GetCodeReference>
        <TypeName>Microsoft.PowerShell.Commands.FileSystemProvider</TypeName>
        <MethodName>Mode</MethodName>
      </GetCodeReference>
    </CodeProperty>
  </Members>
</Type>

Właściwości notatek

Właściwość notatek definiuje właściwość, która ma wartość statyczną.

W poniższym przykładzie właściwość Status, której wartość jest zawsze success, jest dodawana do typu System.IO.DirectoryInfo. Element NoteProperty definiuje właściwość rozszerzoną jako właściwość notatki. Element Name określa nazwę właściwości rozszerzonej. Element Value określa wartość statyczną właściwości rozszerzonej. Element NoteProperty można również dodać do elementów członkowskich MemberSets.

<Type>
  <Name>System.IO.DirectoryInfo</Name>
  <Members>
    <NoteProperty>
      <Name>Status</Name>
      <Value>Success</Value>
    </NoteProperty>
  </Members>
</Type>

Właściwości skryptu

Właściwość skryptu definiuje właściwość, której wartość jest wynikiem skryptu.

W poniższym przykładzie właściwość VersionInfo jest dodawana do typu System.IO.FileInfo. Element ScriptProperty definiuje właściwość rozszerzoną jako właściwość skryptu. Element Name określa nazwę właściwości rozszerzonej. A element GetScriptBlock określa skrypt, który generuje wartość właściwości. Można również dodać element ScriptProperty do elementów członkowskich MemberSets.

<Type>
  <Name>System.IO.FileInfo</Name>
  <Members>
    <ScriptProperty>
      <Name>VersionInfo</Name>
      <GetScriptBlock>
        [System.Diagnostics.FileVersionInfo]::GetVersionInfo($this.FullName)
      </GetScriptBlock>
    </ScriptProperty>
  </Members>
</Type>

Zestawy właściwości

Zestaw właściwości definiuje grupę właściwości rozszerzonych, do których można odwoływać się przy użyciu nazwy zestawu. Na przykład parametr Format-TableProperty może określić określony zestaw właściwości, który ma być wyświetlany. Po określeniu zestawu właściwości wyświetlane są tylko te właściwości, które należą do zestawu.

Nie ma żadnych ograniczeń dotyczących liczby zestawów właściwości, które można zdefiniować dla obiektu. Jednak zestawy właściwości używane do definiowania domyślnych właściwości wyświetlania obiektu muszą być określone w psStandardMembers zestawu elementów członkowskich. W pliku typów Types.ps1xml domyślne nazwy zestawu właściwości obejmują DefaultDisplayProperty, DefaultDisplayPropertySeti DefaultKeyPropertySet. Wszystkie dodatkowe zestawy właściwości dodawane do zestawu PSStandardMembers są ignorowane.

W poniższym przykładzie zestaw właściwości defaultDisplayPropertySet jest dodawany do zestawu psStandardMembers zestawu elementów członkowskich System.ServiceProcess.ServiceController. Element PropertySet definiuje grupę właściwości. Element Name określa nazwę zestawu właściwości. A element ReferencedProperties określa właściwości zestawu. Można również dodać element PropertySet do elementów członkowskich elementu Type.

<Type>
  <Name>System.ServiceProcess.ServiceController</Name>
  <Members>
    <MemberSet>
      <Name>PSStandardMembers</Name>
      <Members>
        <PropertySet>
           <Name>DefaultDisplayPropertySet</Name>
           <ReferencedProperties>
            <Name>Status</Name
            <Name>Name</Name>
            <Name>DisplayName</Name>
          </ReferencedProperties>
        </PropertySet>
      </Members>
    </MemberSet>
  </Members>
</Type>

Zobacz też

About Types.ps1xml

System.Management.Automation

pisanie polecenia cmdlet programu Windows PowerShell