Aracılığıyla paylaş

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

Geniş bir görünüm, görüntülenen her nesne için tek bir değer görüntüler. Görüntülenen değer bir .NET nesne özelliğinin değeri veya bir betiğin değeri olabilir. Varsayılan olarak, bu görünüm için etiket veya üst bilgi yoktur.

Geniş Görünüm Ekranı

Aşağıdaki örnekte, Windows PowerShell'in çıktısı Format-Wide cmdlet'ine aktarıldığında Get-Process cmdlet'i tarafından döndürülen System.Diagnostics.Process nesnesini nasıl görüntülediği gösterilmektedir. (Varsayılan olarak, Get-Process cmdlet'i bir tablo görünümü döndürür.) Bu örnekte, döndürülen her nesne için işlemin adını görüntülemek için iki sütun kullanılır. Nesnenin özelliğinin adı görüntülenmez, yalnızca özelliğin değeri görüntülenir.

Get-Process | Format-Wide

AEADISRV                     agrsmsvc
Ati2evxx                     Ati2evxx
audiodg                      CCC
CcmExec                      communicator
Crypserv                     csrss
csrss                        DevDtct2
DM1Service                   dpupdchk
dwm                          DxStudio
EXCEL                        explorer
GoogleToolbarNotifier        GrooveMonitor
hpqwmiex                     hpservice
Idle                         InoRpc
InoRT                        InoTask
ipoint                       lsass
lsm                          MOM
MSASCui                      notepad
...                          ...

Geniş Görünümü Tanımlama

Aşağıdaki XML, System.Diagnostics.Process nesnesi için geniş görünüm şemasını gösterir.

<View>
  <Name>process</Name>
  <ViewSelectedBy>
    <TypeName>System.Diagnostics.Process</TypeName>
  </ViewSelectedBy>
  <GroupBy>...</GroupBy>
  <Controls>...</Controls>
  <WideControl>
    <WideEntries>
      <WideEntry>
        <WideItem>
          <PropertyName>ProcessName</PropertyName>
        </WideItem>
      </WideEntry>
    </WideEntries>
  </WideControl>
</View>

Geniş bir görünüm tanımlamak için aşağıdaki XML öğeleri kullanılır:

  • Görünüm öğesi, geniş görünümün üst öğesidir. (Bu, tablo, liste ve özel denetim görünümleri için aynı üst öğedir.)
  • Adı öğesi görünümün adını belirtir. Bu öğe tüm görünümler için gereklidir.
  • ViewSelectedBy öğesi, görünümü kullanan nesneleri tanımlar. Bu öğe gereklidir.
  • GroupBy öğesi, yeni bir nesne grubunun ne zaman görüntüleneceğini tanımlar. Belirli bir özelliğin veya betiğin değeri her değiştiğinde yeni bir grup başlatılır. Bu öğe isteğe bağlıdır.
  • Denetimleri öğeleri, geniş görünüm tarafından tanımlanan özel denetimleri tanımlar. Denetimler, verilerin nasıl görüntüleneceğini daha fazla belirtmeniz için size bir yol sağlar. Bu öğe isteğe bağlıdır. Görünüm kendi özel denetimlerini tanımlayabilir veya biçimlendirme dosyasındaki herhangi bir görünüm tarafından kullanılabilecek ortak denetimleri kullanabilir. Özel denetimler hakkında daha fazla bilgi için bkz. Özel Denetim oluşturma.
  • WideControl öğesi ve alt öğeleri görünümde görüntülenen öğeleri tanımlar. Yukarıdaki örnekte görünüm, System.Diagnostics.Process.ProcessName özelliğini görüntüleyecek şekilde tasarlanmıştır.

Basit bir geniş görünümü tanımlayan eksiksiz bir biçimlendirme dosyası örneği için bkz. Geniş Görünüm (Temel).

Geniş Görünümünüz için Tanımlar Sağlama

Geniş görünümler, WideControl öğesinin alt öğelerini kullanarak bir veya daha fazla tanım sağlayabilir. Genellikle, bir görünümün tek bir tanımı olur. Aşağıdaki örnekte görünüm, System.Diagnostics.Process.ProcessName özelliğini görüntüleyen tek bir tanım sağlar. Geniş bir görünüm, bir özelliğin değerini veya betiğin değerini görüntüleyebilir (örnekte gösterilmez).

<WideControl>
  <AutoSize/>
  <ColumnNumber></ColumnNumber>
  <WideEntries>
    <WideEntry>
      <WideItem>
        <PropertyName>ProcessName</PropertyName>
      </WideItem>
    </WideEntry>
  </WideEntries>
</WideControl>

Aşağıdaki XML öğeleri, geniş bir görünüme yönelik tanımlar sağlamak için kullanılabilir:

  • WideControl öğesi ve alt öğeleri görünümde görüntülenen öğeleri tanımlar.
  • Otomatik Boyutlandır öğesi, sütun boyutunun ve sütun sayısının verilerin boyutuna göre ayarlanıp ayarlanmayacağını belirtir. Bu öğe isteğe bağlıdır.
  • ColumnNumber öğesi, geniş görünümde görüntülenen sütun sayısını belirtir. Bu öğe isteğe bağlıdır.
  • WideEntries öğesi görünümün tanımlarını sağlar. Çoğu durumda, bir görünümün tek bir tanımı olur. Bu öğe gereklidir.
  • WideEntry öğesi görünümün tanımını sağlar. En az bir WideEntry gereklidir; ancak, ekleyebileceğiniz öğe sayısı için üst sınır yoktur. Çoğu durumda, bir görünümün tek bir tanımı olur.
  • EntrySelectedBy öğesi, belirli bir tanım tarafından görüntülenen nesneleri belirtir. Bu öğe isteğe bağlıdır ve yalnızca farklı nesneler görüntüleyen birden çok WideEntry öğesi tanımladığınızda gereklidir.
  • WideItem öğesi, görünüm tarafından görüntülenen verileri belirtir. Diğer görünüm türlerinin aksine, geniş bir denetim yalnızca bir öğe görüntüleyebilir.
  • PropertyName öğesi, değeri görünüm tarafından görüntülenen özelliğini belirtir. Bir özellik veya betik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
  • ScriptBlock öğesi, değeri görünüm tarafından görüntülenen betiği belirtir. Bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
  • FormatString öğesi, verileri görüntülemek için kullanılan bir deseni belirtir. Bu öğe isteğe bağlıdır.

Geniş görünüm tanımını tanımlayan eksiksiz bir biçimlendirme dosyası örneği için bkz. Geniş Görünüm (Temel).

Geniş Görünümü Kullanan Nesneleri Tanımlama

Hangi .NET nesnelerinin geniş görünümü kullandığını tanımlamanın iki yolu vardır. görünümün tüm tanımları tarafından görüntülenebilen nesneleri tanımlamak için ViewSelectedBy öğesini kullanabilir veya görünümün belirli bir tanımıyla hangi nesnelerin görüntüleneceğini tanımlamak için EntrySelectedBy öğesini kullanabilirsiniz. Çoğu durumda, bir görünümün tek bir tanımı vardır, bu nedenle nesneler genellikle ViewSelectedBy öğesi tarafından tanımlanır.

Aşağıdaki örnekte, ViewSelectedBy ve TypeName öğeleri kullanılarak geniş görünüm tarafından görüntülenen nesnelerin nasıl tanımlanacağı gösterilmektedir. Belirtebileceğiniz TypeName öğelerinin sayısıyla ilgili bir sınır yoktur ve bunların sırası önemli değildir.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.Diagnostics.Process</TypeName>
  </ViewSelectedBy>
  <WideControl>...</WideControl>
</View>

Aşağıdaki XML öğeleri, geniş görünüm tarafından kullanılan nesneleri belirtmek için kullanılabilir:

  • ViewSelectedBy öğesi, geniş görünüm tarafından hangi nesnelerin görüntüleneceğini tanımlar.
  • TypeName öğesi, görünüm tarafından görüntülenen .NET'i belirtir. Tam .NET türü adı gereklidir. Görünüm için en az bir tür veya seçim kümesi belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.

Tam biçimlendirme dosyası örneği için bkz. Geniş Görünüm (Temel).

Aşağıdaki örnek, ViewSelectedBy ve SelectionSetName öğelerini kullanır. Aynı nesneler için geniş bir görünüm ve tablo görünümü tanımlarken olduğu gibi, birden çok görünüm kullanılarak görüntülenen ilgili bir nesne kümeniz olan seçim kümelerini kullanın. Seçim kümesi oluşturma hakkında daha fazla bilgi için bkz. Seçim Kümelerini Tanımlama.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <SelectionSetName>.NET Type Set</SelectionSetName>
  </ViewSelectedBy>
  <WideControl>...</WideControl>
</View>

Aşağıdaki XML öğeleri, geniş görünüm tarafından kullanılan nesneleri belirtmek için kullanılabilir:

  • ViewSelectedBy öğesi, geniş görünüm tarafından hangi nesnelerin görüntüleneceğini tanımlar.
  • SelectionSetName öğesi, görünüm tarafından görüntülenebilen bir nesne kümesini belirtir. Görünüm için en az bir seçim kümesi veya tür belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.

Aşağıdaki örnekte, EntrySelectedBy öğesi kullanılarak geniş görünümün belirli bir tanımıyla görüntülenen nesnelerin nasıl tanımlanacağı gösterilmektedir. Bu öğeyi kullanarak nesnenin .NET tür adını, bir nesne seçim kümesini veya tanımın ne zaman kullanılacağını belirten bir seçim koşulu belirtebilirsiniz. Seçim koşulları oluşturma hakkında daha fazla bilgi için bkz. veri Görüntülemek için Koşulları Tanımlama.

<WideEntry>
  <EntrySelectedBy>
    <TypeName>.NET Type</TypeName>
  </EntrySelectedBy>
</WideEntry>

Aşağıdaki XML öğeleri, geniş görünümün belirli bir tanımı tarafından kullanılan nesneleri belirtmek için kullanılabilir:

  • EntrySelectedBy öğesi tanım tarafından hangi nesnelerin görüntüleneceğini tanımlar.
  • TypeName öğesi, tanım tarafından görüntülenen .NET'i belirtir. Bu öğeyi kullanırken tam .NET türü adı gereklidir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.
  • SelectionSetName öğesi (gösterilmez), bu tanım tarafından görüntülenebilen bir nesne kümesi belirtir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.
  • SelectionCondition öğesi (gösterilmez), bu tanımın kullanılabilmesi için var olması gereken bir koşulu belirtir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur. Seçim koşullarını tanımlama hakkında daha fazla bilgi için bkz. VeriGörüntülemek için Koşulları Tanımlama .

Geniş Görünümde Nesne Gruplarını Görüntüleme

Geniş görünüm tarafından görüntülenen nesneleri gruplara ayırabilirsiniz. Bu, bir grup tanımladığınız anlamına gelmez; yalnızca belirli bir özelliğin veya betiğin değeri değiştiğinde Windows PowerShell yeni bir grup başlatır. Aşağıdaki örnekte, System.ServiceProcess.ServiceController.ServiceType özelliğinin değeri her değiştiğinde yeni bir grup başlatılır.

<GroupBy>
  <Label>Service Type</Label>
  <PropertyName>ServiceType</PropertyName>
</GroupBy>

Bir grubun ne zaman başlatılacağını tanımlamak için aşağıdaki XML öğeleri kullanılır:

  • GroupBy öğesi, yeni grubu başlatan özelliği veya betiği tanımlar ve grubun nasıl görüntüleneceğini tanımlar.
  • PropertyName öğesi, değeri her değiştiğinde yeni bir grup başlatan özelliği belirtir. Grubu başlatmak için bir özellik veya betik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
  • ScriptBlock öğesi, değeri her değiştiğinde yeni bir grup başlatan betiği belirtir. Grubu başlatmak için bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
  • Label öğesi, her grubun başında görüntülenen bir etiketi tanımlar. Bu öğe tarafından belirtilen metne ek olarak, Windows PowerShell yeni grubu tetikleyen değeri görüntüler ve etiketin önüne ve arkasına boş bir satır ekler. Bu öğe isteğe bağlıdır.
  • CustomControl öğesi, verileri görüntülemek için kullanılan bir denetimi tanımlar. Bu öğe isteğe bağlıdır.
  • CustomControlName öğesi, verileri görüntülemek için kullanılan ortak veya görünüm denetimini belirtir. Bu öğe isteğe bağlıdır.

Grupları tanımlayan eksiksiz bir biçimlendirme dosyası örneği için bkz. Geniş Görünüm (GroupBy).

Biçim Dizelerini Kullanma

Biçimlendirme dizeleri, verilerin nasıl görüntüleneceğini daha ayrıntılı bir şekilde tanımlamak için geniş bir görünüme eklenebilir. Aşağıdaki örnekte, StartTime özelliğinin değeri için biçimlendirme dizesinin nasıl tanımlanacağı gösterilmektedir.

<WideItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} {0:DD} {0:HH}:{0:MM}</FormatString>
</WideItem>

Biçim deseni belirtmek için aşağıdaki XML öğeleri kullanılabilir:

  • WideItem öğesi, görünüm tarafından görüntülenen verileri belirtir.
  • PropertyName öğesi, değeri görünüm tarafından görüntülenen özelliğini belirtir. Bir özellik veya betik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
  • FormatString öğesi, özelliğin veya betik değerinin görünümde nasıl görüntüleneceğini tanımlayan bir biçim deseni belirtir
  • ScriptBlock öğesi (gösterilmez), değeri görünüm tarafından görüntülenen betiği belirtir. Bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.

Aşağıdaki örnekte, betiğin değerini biçimlendirmek için ToString yöntemi çağrılır. Betikler bir nesnenin herhangi bir yöntemini çağırabilir. Bu nedenle, bir nesnenin biçimlendirme parametreleri olan ToStringgibi bir yöntemi varsa, betiğin çıkış değerini biçimlendirmek için bu yöntemi çağırabilir.

<WideItem>
  <ScriptBlock>
    [string]::Format("{0,-10} {1,-8}", $_.LastWriteTime.ToString("d"), $_.LastWriteTime.ToString("t"))
  </ScriptBlock>
</WideItem>

aşağıdaki XML öğesi, ToString yöntemini çağırmak için kullanılabilir:

  • WideItem öğesi, görünüm tarafından görüntülenen verileri belirtir.
  • ScriptBlock öğesi (gösterilmez), değeri görünüm tarafından görüntülenen betiği belirtir. Bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.

Ayrıca Bkz.

  • Last updated on