Dosyayı Biçimlendirmeye Genel Bakış

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

PowerShell, neyin görüntüleneceğini ve görüntülenen verilerin nasıl biçimlendirileceğini belirlemek için bu biçimlendirme dosyalarındaki verileri kullanır. Görüntülenen veriler bir nesnenin özelliklerini veya bir komut dosyasının değerini içerebilir. Bir nesnenin iki özelliğinin değerini eklemek ve ardından toplamı bir veri parçası olarak görüntülemek gibi, bir nesnenin özelliklerinden doğrudan elde edilemeyen bazı değerleri görüntülemek istiyorsanız komut dosyaları kullanılır. Görüntülenen verilerin formatlanması, görüntülemek istediğiniz nesnelerin görünümleri tanımlanarak yapılır. 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ında herhangi bir sınırlama 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çin Sarma Öğesi.

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

• Biçimlendirme dosyasının tüm görünümleri tarafından kullanılabilen ortak kontroller. Kontroller, verilerin nasıl görüntüleneceği konusunda size daha hassas kontrol sağlar. Denetimler hakkında daha fazla bilgi için bkz. Özel Denetimleri 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ü tanımlayan bir dizi XML etiketiyle tanımlanır. Her görünüm, görünümün adını, görünümü kullanan nesneleri ve tablo görünümüne ilişkin sütun ve satır bilgileri gibi görünümün öğelerini içerir.

Tablo Görünümü

Bir nesnenin özelliklerini veya kod bloğu değerini bir veya daha fazla sütunda listeler. Her sütun, nesnenin tek bir özelliğini veya bir kod değerini temsil eder. Bir nesnenin tüm özelliklerini, bir nesnenin özelliklerinin bir alt kümesini veya özelliklerin ve kod değerlerinin bir 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 aktarmaya ç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ü

Bir nesnenin özelliklerini veya kod değerini tek bir sütunda listeler. Listenin her satırında isteğe bağlı bir etiket veya özellik adı ve ardından özelliğin veya komut dosyasının değeri görüntülenir. Liste görünümü oluşturmak, bir nesneyi Format-List cmdlet'ine aktarmaya çok benzer. Bu görünüm hakkında daha fazla bilgi için bkz. Liste Görünümü.

Geniş Görüş

Bir nesnenin tek bir özelliğini veya bir komut dosyası değerini bir veya daha fazla sütunda listeler. Bu görünüm için etiket veya başlık yok. Geniş görünüm oluşturmak, bir nesneyi Format-Wide cmdlet'ine aktarmaya ç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 kod değerlerinin özelleştirilebilir bir görünümünü görüntüler. Tek başına bir ö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 aktarmaya ç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, hangi görünümü oluşturmak istediğinize 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 referans vermek için kullanılan kullanıcı dostu bir adı belirten bir Ad öğ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 control öğ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>

Kontrol öğesi içinde bir veya daha fazla giriş öğesi tanımlayabilirsiniz. Birden çok tanım kullanıyorsanız, her tanımı hangi .NET nesnelerinin kullanacağını belirtmeniz gerekir. Tipik olarak her kontrol için yalnızca bir tanımla birlikte yalnızca bir giriş gereklidir.

<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ş öğesi içinde, o görünüm tarafından görüntülenen .NET özelliklerini veya komut dosyalarını tanımlayan item öğelerini 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 örnek, iki sütun içeren bir tablo görünümünü tanımlamak için kullanılan XML etiketlerini gösterir. ViewDefinitions öğesi, biçimlendirme dosyasında tanımlanan tüm görünümler için kapsayıcı öğedir. Görünüm öğesi belirli tabloyu, listeyi, geniş veya özel görünümü tanımlar. Her View öğesi içinde Name öğesi görünümün adını belirtir, ViewSelectedBy öğesi görünümü kullanan nesneleri ve farklı kontrol öğelerini (aşağıdaki örnekte gösterilen TableControl öğesi gibi) tanımlar. görünümün türünü tanımlayın.

<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 Bakınız

Liste Görünümü Oluşturma

Tablo Görünümü Oluşturma

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

Özel Kontroller Oluşturma

PowerShell Biçimlendirmesi ve Türleri Dosyası Yazma