Tulajdonságok deklarálása paraméterekként

Ez a témakör alapvető információkat tartalmaz, amelyekre a parancsmag paramétereinek deklarálása előtt szükség van.

Ha egy parancsmag paramétereit a parancsmagosztályon belül deklarálhatja, határozza meg az egyes paramétereket képviselő nyilvános tulajdonságokat, majd adjon hozzá egy vagy több Paraméter attribútumot mindegyik tulajdonsághoz. A Windows PowerShell a paraméterattribútumok használatával azonosítja a tulajdonságot parancsmag-paraméterként. A Paraméter attribútum deklaratív alapszintaxisa [Parameter()] a következő: .

Az alábbi példában egy kötelező paraméterként definiált tulajdonságot mutatunk be.

[Parameter(Position = 0, Mandatory = true)]
public string UserName
{
  get { return userName; }
  set { userName = value; }
}
private string userName;

Íme néhány dolog, amit meg kell jegyezni a paraméterekkel kapcsolatban.

• A paramétereket explicit módon nyilvánosként kell megjelölni. Azok a paraméterek, amelyek nincsenek alapértelmezettként nyilvánosként megjelölve a belsőre, és a nyilvános Windows PowerShell találhatók.

• A paramétereket Microsoft-típusként .NET-keretrendszer a jobb paraméterérvényesítés érdekében. Az értékkészletből egy értékre korlátozott paramétereket például enumerálástípusként kell definiálni. Az URI értéket Uniform Resource Identifier paramétereknek System.Uritípusúnak kell lennie.

• Kerülje az alapszintű sztringparamétereket a szabad szöveges tulajdonságokon túl.

• Bármilyen számú paraméterkészlethez adhat hozzá paramétert. A paraméterkészletekkel kapcsolatos további információkért lásd: Parancsmag-paraméterkészletek.

Windows PowerShell olyan gyakori paramétereket is biztosít, amelyek automatikusan elérhetők minden parancsmag számára. További információ ezekről a paraméterekről és aliasaikról: Parancsmagok – gyakori paraméterek.

Lásd még:

Parancsmagok gyakori paraméterei

A parancsmag-paraméter típusai

Windows PowerShell-parancsmag írása