Biçimlendirme Dosyasına Genel Bakış

Komutlar (cmdlet'ler, işlevler ve betikler) tarafından döndürülen nesnelerin görüntüleme biçimi, biçimlendirme dosyaları (format.ps1xml) kullanılarak tanımlanır. Bu dosyalardan bazıları PowerShell tarafından sağlanan komutlar tarafından döndürülen nesnelerin görüntü biçimini tanımlamak için sağlanır; örneğin, Get-Process cmdlet'i tarafından döndürülen System.Diagnostics.Process nesnesi. Ancak, varsayılan görüntü biçimlerinin üzerine yazmak için kendi özel biçimlendirme dosyalarınızı oluşturabilir veya kendi komutlarınızın döndürdiği nesnelerin görünümünü tanımlamak için özel bir biçimlendirme dosyası yazabilirsiniz.

Önemli

Biçimlendirme dosyaları, işlem hattına döndürülen bir nesnenin öğelerini belirlemez. Bir nesne işlem hattına döndürülürse, bazıları görüntülenmese bile bu nesnenin tüm üyeleri kullanılabilir.

PowerShell, görüntülenen verileri ve görüntülenen verilerin nasıl biçimlendirildiğini belirlemek için bu biçimlendirme dosyalarındaki verileri kullanır. Görüntülenen veriler bir nesnenin özelliklerini veya bir betiğin değerini içerebilir. Betikler, bir nesnenin iki özelliğinin değerini ekleme ve toplamı bir veri parçası olarak görüntüleme gibi doğrudan bir nesnenin özelliklerinden kullanılamayan bir değer görüntülemek istiyorsanız kullanılır. Görüntülenen verilerin biçimlendirmesi, görüntülemek istediğiniz nesnelerin görünümlerini tanımlayarak gerçekleştirilir. Her nesne için tek bir görünüm tanımlayabilir, birden çok nesne için tek bir görünüm tanımlayabilir veya aynı nesne için birden çok görünüm tanımlayabilirsiniz. Tanımlayabileceğiniz görünüm sayısıyla ilgili bir sınır yoktur.

Dosyaları Biçimlendirmenin Ortak Özellikleri

Her biçimlendirme dosyası, dosya tarafından tanımlanan tüm görünümlerde paylaşılabilen aşağıdaki bileşenleri tanımlayabilir:

• Verilerin sütun genişliğinden uzun olması durumunda tablo satırlarında görüntülenen verilerin bir sonraki satırda görüntülenip görüntülenmeyeceği gibi varsayılan yapılandırma ayarı. Bu ayarlar hakkında daha fazla bilgi için bkz. TableRowEntry içinWrap Öğesi.

• Biçimlendirme dosyasının görünümlerinden herhangi biri tarafından görüntülenebilen nesne kümeleri. Bu kümeler (seçim kümeleri olarak adlandırılır) hakkında daha fazla bilgi için bkz. Nesne Kümesi Tanımlama.

• Biçimlendirme dosyasının tüm görünümleri tarafından kullanılabilecek yaygın denetimler. Denetimler, verilerin nasıl görüntüleneceği konusunda daha ayrıntılı denetim sağlar. Denetimler hakkında daha fazla bilgi için bkz. Özel Denetim Tanımlama.

Görünümleri Biçimlendirme

Biçimlendirme görünümleri nesneleri tablo biçiminde, liste biçiminde, geniş biçimde ve özel biçimde görüntüleyebilir. Çoğunlukla, her biçimlendirme tanımı görünümü açıklayan bir XML etiketleri kümesiyle açıklanır. Her görünüm görünümün adını, görünümü kullanan nesneleri ve bir tablo görünümü için sütun ve satır bilgileri gibi görünümün öğelerini içerir.

Tablo Görünümü

Bir veya daha fazla sütundaki bir nesnenin veya betik bloğu değerinin özelliklerini listeler. Her sütun, nesnenin tek bir özelliğini veya bir betik değerini temsil eder. Bir nesnenin tüm özelliklerini, bir nesnenin özelliklerinin bir alt kümesini veya özelliklerin ve betik değerlerinin birleşimini görüntüleyen bir tablo görünümü tanımlayabilirsiniz. Tablonun her satırı döndürülen bir nesneyi temsil eder. Tablo görünümü oluşturmak, bir nesneyi Format-Table cmdlet'ine yöneltmeye çok benzer. Bu görünüm hakkında daha fazla bilgi için bkz. Tablo Görünümü.

Liste Görünümü

Tek bir sütundaki bir nesnenin veya betik değerinin özelliklerini listeler. Listenin her satırı isteğe bağlı bir etiket veya özellik adını ve ardından özellik veya betiğin değerini görüntüler. Liste görünümü oluşturmak, bir nesneyi Format-List cmdlet'ine bağlamaya çok benzer. Bu görünüm hakkında daha fazla bilgi için bkz. Liste Görünümü.

Geniş Görünüm

Bir veya daha fazla sütundaki bir nesnenin veya betik değerinin tek bir özelliğini listeler. Bu görünüm için etiket veya üst bilgi yok. Geniş bir görünüm oluşturmak, bir nesneyi Format-Wide cmdlet'ine bağlamaya çok benzer. Bu görünüm hakkında daha fazla bilgi için bkz. Geniş Görünüm.

Özel Görünüm

Tablo görünümlerinin, liste görünümlerinin veya geniş görünümlerin katı yapısına uymayan nesne özelliklerinin veya betik değerlerinin özelleştirilebilir bir görünümünü görüntüler. Tek başına özel görünüm tanımlayabilir veya tablo görünümü veya liste görünümü gibi başka bir görünüm tarafından kullanılan özel bir görünüm tanımlayabilirsiniz. Özel görünüm oluşturmak, bir nesneyi Format-Custom cmdlet'ine bağlamaya çok benzer. Bu görünüm hakkında daha fazla bilgi için bkz. Özel Görünüm.

Görünümün Bileşenleri

Aşağıdaki XML örnekleri, bir görünümün temel XML bileşenlerini gösterir. Tek tek XML öğeleri, oluşturmak istediğiniz görünüme bağlı olarak değişir, ancak görünümlerin temel bileşenleri aynıdır.

Başlangıç olarak, her görünümün, görünüme başvurmak için kullanılan kullanıcı dostu bir ad belirten bir Name öğesi vardır. görünüm tarafından hangi .NET nesnelerinin görüntüleneceğini tanımlayan bir ViewSelectedBy öğesi ve görünümü tanımlayan bir denetimi öğesi.

<ViewDefinitions>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <TableControl>...</TableControl>
  </View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <ListControl>...</ListControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <WideControl>...</WideControl>
  <View>
  <View>
    <Name>NameOfView</Name>
    <ViewSelectedBy>...</ViewSelectedBy>
    <CustomControl>...</CustomControl>
  </View>
</ViewDefinitions>

Denetim öğesinde, bir veya daha fazla girişi öğesi tanımlayabilirsiniz. Birden çok tanım kullanıyorsanız, her tanımı hangi .NET nesnelerinin kullanacağını belirtmeniz gerekir. Genellikle her denetim için yalnızca bir tanım içeren tek bir giriş gerekir.

<ListControl>
  <ListEntries>
    <ListEntry>
      <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
    <ListEntry>
        <EntrySelectedBy>...</EntrySelectedBy>
      <ListItems>...</ListItems>
    </ListEntry>
  </ListEntries>
</ListControl>

Bir görünümün her giriş öğesinde, o görünüm tarafından görüntülenen .NET özelliklerini veya betiklerini tanımlayan öğeleri öğesini belirtirsiniz.

<ListItems>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
  <ListItem>...</ListItem>
</ListItems>

Önceki örneklerde gösterildiği gibi, biçimlendirme dosyası birden çok görünüm içerebilir, bir görünüm birden çok tanım içerebilir ve her tanım birden çok öğe içerebilir.

Tablo Görünümü Örneği

Aşağıdaki örnekte, iki sütun içeren bir tablo görünümünü tanımlamak için kullanılan XML etiketleri gösterilmektedir. ViewDefinitions öğesi, biçimlendirme dosyasında tanımlanan tüm görünümlerin kapsayıcı öğesidir. Görünüm öğesi belirli bir tabloyu, listeyi, geniş veya özel görünümü tanımlar. Her Görünüm öğesinde, Adı öğesi görünümün adını belirtir, ViewSelectedBy öğesi görünümü kullanan nesneleri tanımlar ve farklı denetim öğeleri (aşağıdaki örnekte gösterilen TableControl öğesi gibi) görünümün türünü tanımlar.

<ViewDefinitions>
  <View>
    <Name>Name of View</Name>
    <ViewSelectedBy>
      <TypeName>Object to display using this view</TypeName>
      <TypeName>Object to display using this view</TypeName>
    </ViewSelectedBy>
    <TableControl>
      <TableHeaders>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
        <TableColumnHeader>
          <Width></Width>
        </TableColumnHeader>
      </TableHeaders>
      <TableRowEntries>
        <TableRowEntry>
          <TableColumnItems>
            <TableColumnItem>
              <PropertyName>Header for column 1</PropertyName>
            </TableColumnItem>
            <TableColumnItem>
              <PropertyName>Header for column 2</PropertyName>
            </TableColumnItem>
          </TableColumnItems>
        </TableRowEntry>
      </TableRowEntries>
    </TableControl>
  </View>
</ViewDefinitions>

Ayrıca Bkz.

liste görünümü oluşturma

tablo görünümü oluşturma

Geniş Görünüm oluşturma

özel denetimler oluşturma

PowerShell Biçimlendirmesi ve Türleri Dosyası Yazma