WebDavSessionGetFolderAsync Method (Uri, IDictionaryString, String, CancellationToken)

IT Hit WebDAV Classes Reference

Returns IFolder corresponding to path.

Namespace: ITHit.WebDAV.Client
Assembly: ITHit.WebDAV.Client (in ITHit.WebDAV.Client.dll) Version: 6.0.4052-Beta

Syntax

C++

Copy

public Task<IFolder> GetFolderAsync(
	Uri path,
	IDictionary<string, string> headers = null,
	CancellationToken cancellationToken = null
)

Public Function GetFolderAsync ( 
	path As Uri,
	Optional headers As IDictionary(Of String, String) = Nothing,
	Optional cancellationToken As CancellationToken = Nothing
) As Task(Of IFolder)

public:
virtual Task<IFolder^>^ GetFolderAsync(
	Uri^ path, 
	IDictionary<String^, String^>^ headers = nullptr, 
	CancellationToken cancellationToken = nullptr
) sealed

abstract GetFolderAsync : 
        path : Uri * 
        ?headers : IDictionary<string, string> * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _headers = defaultArg headers null
        let _cancellationToken = defaultArg cancellationToken null
*)
-> Task<IFolder> 
override GetFolderAsync : 
        path : Uri * 
        ?headers : IDictionary<string, string> * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _headers = defaultArg headers null
        let _cancellationToken = defaultArg cancellationToken null
*)
-> Task<IFolder>

Parameters

path: Type: SystemUri
Path to the folder.
headers (Optional): Type: System.Collections.GenericIDictionaryString, String
Request headers.
cancellationToken (Optional): Type: System.ThreadingCancellationToken
Propagates notification that operations should be canceled.

Return Value

Type: TaskIFolder
Folder corresponding to requested path.

Implements

ISessionGetFolderAsync(Uri, IDictionaryString, String, CancellationToken)

Exceptions

Exception	Condition
UnauthorizedException	Incorrect credentials provided or insufficient permissions to access the requested item.
NotFoundException	The requested folder doesn't exist on the server.
ForbiddenException	The server refused to fulfill the request.
WebDavException	Unexpected error occurred.

Examples

Copy

string license = "<?xml version='1.0' encoding='utf...
WebDavSession session = new WebDavSession(license, new HttpClientHandler() { Credentials = new NetworkCredential("User1", "pwd") });

IFolder folder = null;
try
{
    folder = await session.GetFolderAsync(new Uri("https://server/Products/"));
}
catch(UnauthorizedException)
{
    Console.WriteLine("Incorrect user name or password.");
}
catch(NotFoundException)
{
    Console.WriteLine("Folder not found.");
}

if (folder != null)
{
    Console.WriteLine(folder.LastModified.ToString());
}

Reference

WebDavSession Class

GetFolderAsync Overload

ITHit.WebDAV.Client Namespace