SqlMetal 命令列工具可為 .NET Framework 的 LINQ to SQL 組件產生代碼和映射。通過應用本主題後面出現的選項,可以指示 SqlMetal 執行若干種不同的操作,其中包括:
預設情況下, SQLMetal 檔案位於 drive:"Program Files"Microsoft SDKs"Windows"vn.nn"bin 下。
sqlmetal [options] [<input file>]
選項
若要查看最新的選項列表,請從安裝位置的命令提示字元處鍵入 sqlmetal /? 。
串連選項
|
選項 |
說明 |
|
/server: <名稱> |
指定資料庫伺服器名稱。 |
|
/database: <名稱> |
指定伺服器上的資料庫目錄。 |
|
/user: <名稱> |
指定登入使用者識別碼。預設值: 使用 Windows 身分識別驗證。 |
|
/password: <密碼> |
指定登入密碼。預設值:使用 Windows 身分識別驗證。 |
|
/conn: <連接字串> |
指定資料庫連接字串。不能與 /server、/database、/user 或 /password 選項一起使用。
請勿在連接字串中包括檔案名稱。而是應將檔案名稱作為輸入檔案添加到命令列中。例如,下行命令將“c:"northwnd.mdf”指定為輸入檔案:sqlmetal /code:"c:"northwind.cs" /language:csharp "c:"northwnd.mdf"。 |
|
/timeout: <秒> |
指定 SqlMetal 訪問資料庫時的逾時值。預設值:0(即沒有時間限制)。 |
提取選項
|
選項 |
說明 |
|
/views |
提取資料庫檢視。 |
|
/functions |
提取資料庫函數。 |
|
/sprocs |
提取預存程序。 |
輸出選項
|
選項 |
說明 |
|
/dbml [:檔案] |
以 .dbml 副檔名發送輸出。不能與 /map 選項一起使用。 |
|
/code [:檔案] |
以原始碼形式發送輸出。不能與 /dbml 選項一起使用。 |
|
/map [:檔案] |
產生 XML 對應檔而不是屬性。不能與 /dbml 選項一起使用。 |
雜項
|
選項 |
說明 |
|
/language: <語言> |
指定原始碼語言。
有效 <語言> 包括:vb、csharp。
預設值:從代碼檔案的副檔名派生。 |
|
/namespace: <名稱> |
為產生的程式碼指定命名空間。預設值:無命名空間。 |
|
/context: <類型> |
指定資料內容類的名稱。預設值:從資料庫名稱派生。 |
|
/entitybase: <類型> |
為產生的程式碼中的實體類指定基類。預設值:實體沒有基類。 |
|
/pluralize |
自動為類和成員名稱應用複數或單數形式。
此選項只在(美國)英文版中可用。 |
|
/serialization: <選項> |
產生可序列化的類。
有效 <選項> 包括:None、Unidirectional。預設值: None。
有關更多資訊,請參見序列化 (LINQ to SQL)。 |
輸入檔案
|
選項 |
說明 |
|
<input file> |
指定 SQL Server Express .mdf 檔案、SQL Server Compact 3.5 .sdf 檔案或 .dbml 中間檔案。 |
備忘
SqlMetal 功能實際涉及兩個步驟:
若要從 .mdf 檔案中提取中繼資料,必須在所有其他選項後指定 .mdf 檔案的名稱。
如果未指定 /server,則假定為 localhost/sqlexpress。
如果存在下列一種或多種情況,Microsoft SQL Server 2005 將引發異常:
若要指定一個輸入檔案名稱,請將該名稱作為輸入檔案添加到命令列。不支援在連接字串中包括檔案名稱(使用 /conn 選項)。
產生一個包含提取的 SQL 中繼資料的 .dbml 檔案:
sqlmetal /server:myserver /database:northwind /dbml:mymeta.dbml
使用 SQL Server Express 產生一個包含從 .mdf 檔案中提取的 SQL 中繼資料的 .dbml 檔案:
s qlmetal /dbml:mymeta.dbml mydbfile.mdf
產生一個包含從 SQL Server Express 中提取的 SQL 中繼資料的 .dbml 檔案:
sqlmetal /server:."sqlexpress /dbml:mymeta.dbml /database:northwind
基於 .dbml 中繼資料檔案產生原始碼:
sqlmetal /namespace:nwind /code:nwind.cs /language:csharp mymetal.dbml
直接基於 SQL 中繼資料產生原始碼:
sqlmetal /server:myserver /database:northwind /namespace:nwind /code:nwind.cs /language:csharp