Term.CreateLabel 方法
命名空間: Microsoft.SharePoint.Client.Taxonomy
組件: Microsoft.SharePoint.Client.Taxonomy.Silverlight (在 Microsoft.SharePoint.Client.Taxonomy.Silverlight.dll 中); Microsoft.SharePoint.Client.Taxonomy.Phone (在 Microsoft.SharePoint.Client.Taxonomy.Phone.dll 中) Microsoft.SharePoint.Client.Taxonomy (在 Microsoft.SharePoint.Client.Taxonomy.dll 中)
語法
'宣告
Public Function CreateLabel ( _
labelName As String, _
lcid As Integer, _
isDefault As Boolean _
) As Label
'用途
Dim instance As Term
Dim labelName As String
Dim lcid As Integer
Dim isDefault As Boolean
Dim returnValue As Label
returnValue = instance.CreateLabel(labelName, _
lcid, isDefault)
public Label CreateLabel(
string labelName,
int lcid,
bool isDefault
)
參數
labelName
類型:System.String新的Label名稱
lcid
類型:System.Int32若要建立的標籤 LCID
isDefault
類型:System.Boolean此Label是否會 lcid 的預設Label
傳回值
類型:Microsoft.SharePoint.Client.Taxonomy.Label
Term新Label
例外狀況
例外狀況 | 條件 |
---|---|
UnauthorizedAccessException | 使用者沒有足夠的權限,才能執行此作業。 |
TermStoreOperationException | 這項作業中孤立的字詞TermSet無效。作業失敗。 |
ArgumentException | 標籤名稱不正確,它包含無效的字元或太長。 |
ArgumentNullException | 標籤名稱是null 參考 (未執行任何動作 於 Visual Basic 中)或空字串。 |
ArgumentOutOfRangeException | 呼叫CommitAll()方法,將這項變更儲存至資料庫。不正確。 |
ArgumentException | 無預設標籤,以及名稱已經存在的此 lcid,將會建立標籤。 |
備註
labelName值會 normailized 成一份修剪連續空格及&字元取代的字元 (\uFF06) 寬字元版本。必須為非空白、 不能超過 255 個字元,以及不能包含下列字元;"< >|&tab
Label物件的名稱不區分大小寫。非預設Label建立名稱時,它不能有相同名稱 lcid 任何現有Label 。如果這是要做為預設值建立,它可以具有現有Label相同的名稱。不建立新的標籤,而是現有的標籤會成為 LCID 預設標籤。
目前的使用者必須使用這個方法TaxonomyRights.EditTerm權限。