PowerShell - Çok satırlı yorum

<# #> Etiketlerini Kullanma

PowerShell komut dosyalarında çok satırlı yorumlar oluşturmak için yorumların başında <# etiketini ve yorumların sonunda #> etiketini kullanın. Yorum bloğunun içindeki tüm satırlar yorumların parçasıdır.

Çok Satırlı Yorumlar:

<#
Hello, this is 1st line of multiline comments,
this is 2nd line,
this is 3rd line.
#>

Programlamada kod hakkında açıklamalar veya ayrıntılar sağlamak için yorum bloğu kullanırız. Yorumlar, her programcının/geliştiricinin programı kolayca anlayabilmesi için programı belgelemek için kullanılır. Bunları kodda nasıl kullanabileceğimizi anlamak için örnekte çok satırlı yorumları kullanalım:

Çok Satırlı Yorumlar:

<#  
This PowerShell script is
used to print the first ten 
whole numbers
#>

0..9 | % { write " $_" }

ÇIKTI:

 0
 1
 2
 3
 4
 5
 6
 7
 8
 9

Yukarıdaki örnekte, betiğe <# ile başlayan ve #> ile biten, 0 ile 9 arası.

Not: Uygun şekilde yorumlanan kodun geliştiriciler ve bakım personeli tarafından anlaşılması kolaydır.

# kullanarak tek bir satıra yorum yapabiliriz. PowerShell 2.0 veya daha eski sürümlerde, çok satırlı yorum eklemenin tek seçeneği, PowerShell yorumlayıcısı tarafından okunmasını istemediğimiz her satırın başında # karakterini kullanmaktı.

Bu, kod açıklamasında on veya daha fazla satır varsa, her satırın başına on kez # koymamız gerektiği anlamına gelir. Bunun gibi:

Çok Satırlı Yorumlar:

# Hello, we are at 1st line of multiline comments,
# we are at 2nd line,
# we are at 3rd line.
# we are at 4th line.
# we are at 5th line.

Her satırın başına tekrar tekrar # yazmak sıkıcı görünmüyor mu? Ancak tek satırlık yorumları aşağıdaki gibi yazmakta fayda var.

Tek Satırlı Yorumlar:

# This is the single-line comment in PowerShell.

Bir önceki bölümde yazdığımız örneği tek satırlık yorum kullanarak yeniden yazalım.

Tek Satırlı Yorumlar:

# This PowerShell script is used to print the first ten whole numbers
0..9 | % { write " $_" }

ÇIKTI:

0
1
2
3
4
5
6
7
8
9

Burada kodu açıklamak için tek satırlık bir yorum kullanılmıştır. Yorum bloğu içinde söz dizimi veya ifadenin yürütülmeyeceğini unutmayın. Aşağıda bir örnek görelim:

Çok Satırlı Yorumlar:

<#
Get-Location
#>

Get-Location yorum bloğunda olduğundan yukarıdaki kod pasajında herhangi bir çıktı alamadık. Neden? Bunun nedeni, PowerShell'in yürütme sırasında # anahtar kelimelerle veya <# #> anahtar kelimeler arasında herhangi bir şeyle karşılaştığında kod bölümünü atlamasıdır.

Kısayol Tuşlarını Kullanma

Visual Studio'da PowerShell betiği yazarken çok satırlı yorumlar eklemek için kısayol tuşlarını kullanın.

Kısayol Tuşlarını Kullanın:

Hello, we are in 1st line of multiline comments,
We are at the 2nd line,
We are at the 3rd line.
We are at the 4th line.
We are at the 5th line.

Diyelim ki satırların üstüne yorum yapmak istiyoruz. Bunun için öncelikle satırları seçeceğiz, ardından ALT + SHIFT + A tuşlarına basacağız. Seçilen satırları <# #> ile <# seçili satırlar #> olarak içine alacaktır. Aşağıdaki örneğe bakın.

ÇIKTI:

<# 
Hello, we are in 1st line of multiline comments,
We are at the 2nd line,
We are at the 3rd line.
We are at the 4th line.
We are at the 5th line.
#>

Bunların hepsi PowerShell'deki çok satırlı yorumlarla ilgilidir.