關於使用

發行項
05/09/2024

簡短描述

可讓您指出會話中使用的命名空間。

詳細描述

using語句可讓您指定工作階段中使用的命名空間。新增命名空間可簡化 .NET 類別和成員的使用方式，並可讓您從腳本模組和元件匯入類別。

using語句必須位於腳本的任何其他語句之前。

using語句不應該與using:變數的範圍修飾詞混淆。如需詳細資訊，請參閱 about_Remote_Variables。

Syntax

若要指定要解析類型的 .NET 命名空間：

using namespace <.NET-namespace>

若要從 PowerShell 模組載入類別：

using module <module-name>

若要從 .NET 元件預先載入類型：

using assembly <.NET-assembly-path>

指定命名空間可讓您更輕鬆地依其簡短名稱參考型別。

載入元件會在剖析時，將 .NET 類型從該元件預先載入腳本。這可讓您建立新的 PowerShell 類別，以使用預先載入的元件中的類型。

如果您未建立新的 PowerShell 類別，請改用 Add-Type Cmdlet。如需詳細資訊，請參閱 Add-Type。

範例

範例 1 - 新增 typename 解析的命名空間

下列腳本會取得「Hello World」字串的密碼編譯哈希。

請注意和 using namespace System.Text 如何簡化和中 [Stream]System.Text[MemoryStream] 對的System.IO參考。[UnicodeEncoding]using namespace System.IO

using namespace System.Text
using namespace System.IO

[string]$string = "Hello World"
## Valid values are "SHA1", "SHA256", "SHA384", "SHA512", "MD5"
[string]$algorithm = "SHA256"

[byte[]]$stringbytes = [UnicodeEncoding]::Unicode.GetBytes($string)

[Stream]$memorystream = [MemoryStream]::new($stringbytes)
$hashfromstream = Get-FileHash -InputStream $memorystream `
  -Algorithm $algorithm
$hashfromstream.Hash.ToString()

範例 2 - 從文稿模組載入類別

在此範例中，我們有一個名為 CardGames 的 PowerShell 腳本模組，其定義下列類別：

CardGames.Deck
CardGames.Card

Import-Module#requires和語句只會匯入模組函式、別名和變數，如模組所定義。類別不會匯入。命令會 using module 匯入模組，並同時載入類別定義。

using module CardGames
using namespace CardGames

[Deck]$deck = [Deck]::new()
$deck.Shuffle()
[Card[]]$hand1 = $deck.Deal(5)
[Card[]]$hand2 = $deck.Deal(5)
[Card[]]$hand3 = $deck.Deal(5)

範例 3 - 從元件載入類別

此範例會載入元件，使其類別可用來建立新的PowerShell類別。下列腳本會建立衍生自 DirectoryContext 類別的新 PowerShell 類別。

using assembly 'C:\Program Files\PowerShell\7\System.DirectoryServices.dll'
using namespace System.DirectoryServices.ActiveDirectory

class myDirectoryClass : System.DirectoryServices.ActiveDirectory.DirectoryContext
{

  [DirectoryContext]$domain

  myDirectoryClass([DirectoryContextType]$ctx) : base($ctx)
  {
    $this.domain = [DirectoryContext]::new([DirectoryContextType]$ctx)
  }

}

$myDomain = [myDirectoryClass]::new([DirectoryContextType]::Domain)
$myDomain

domain                                                    Name UserName ContextType
------                                                    ---- -------- -----------
System.DirectoryServices.ActiveDirectory.DirectoryContext                    Domain

共用方式為