TaskItem.FileName Property

Reference

Definition

Namespace:: EnvDTE

Assembly:: EnvDTE.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.11.40262

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets or gets a string representing the file name that was passed to the Task List window when the task item was created.

public:
 property System::String ^ FileName { System::String ^ get(); void set(System::String ^ value); };

public:
 property Platform::String ^ FileName { Platform::String ^ get(); void set(Platform::String ^ value); };

[System.Runtime.InteropServices.DispId(7)]
public string FileName { [System.Runtime.InteropServices.DispId(7)] get; [System.Runtime.InteropServices.DispId(7)] set; }

[<System.Runtime.InteropServices.DispId(7)>]
[<get: System.Runtime.InteropServices.DispId(7)>]
[<set: System.Runtime.InteropServices.DispId(7)>]
member this.FileName : string with get, set

Public Property FileName As String

Property Value

String

A string representing the file name that was passed to the Task List window when the task item was created.

Attributes: DispIdAttribute

Examples

[Visual Basic]

Sub FilenameExample()  
   ' Before running, add a task to the Task List.  
   Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindTaskList)  
   Dim TL As TaskList = win.Object  
   Dim TLItem As TaskItem = TL.TaskItems.Item(1)  
   Dim msg As String  

   ' List properties of the Task Item.  
   msg = "TaskItem Category property value: " & TLItem.Category & vbCr  
   msg = msg & "TaskItem SubCategory property value: " & TLItem.SubCategory & vbCr  
   msg = msg & "TaskItem Checked property value: " & TLItem.Checked & vbCr  
   msg = msg & "TaskItem Displayed property value: " & TLItem.Displayed & vbCr  
   ' The following line will fail with an error unless a file is   
   ' associated with the Task Item.  
   msg = msg & "TaskItem Filename property value: " & TLItem.FileName & vbCr  
   msg = msg & "TaskItem IsSettable property value: " & TLItem.IsSettable(vsTaskListColumn.vsTaskListColumnCheck) & vbCr  
   msg = msg & "TaskItem Priority property value: " & TLItem.Priority & vbCr  
   MsgBox(msg)  
End Sub

Remarks

The empty string is a special token that indicates there is no file name associated with the task item. The FileName property returns the error, Unspecified Error, if there is no value for it (that is, no file name).

Applies to

Share via