Implementation of the SSH File Transfer Protocol (SFTP) over SSH.
public class SftpClient : BaseClient, ISftpClient, IBaseClient, IDisposableInitializes a new instance of the Renci.SshNet.SftpClient class.
public SftpClient(ConnectionInfo connectionInfo)connectionInfo ConnectionInfo
The connection info.
connectionInfo is null.
Initializes a new instance of the Renci.SshNet.SftpClient class.
public SftpClient(string host, int port, string username, string password)host string
Connection host.
port int
Connection port.
username string
Authentication username.
password string
Authentication password.
password is null.
host is invalid.
-or-
username is null or contains only whitespace characters.
port is not within System.Net.IPEndPoint.MinPort and System.Net.IPEndPoint.MaxPort.
Initializes a new instance of the Renci.SshNet.SftpClient class.
public SftpClient(string host, string username, string password)host string
Connection host.
username string
Authentication username.
password string
Authentication password.
password is null.
host is invalid.
-or-
username is null contains only whitespace characters.
Initializes a new instance of the Renci.SshNet.SftpClient class.
public SftpClient(string host, int port, string username, params IPrivateKeySource[] keyFiles)host string
Connection host.
port int
Connection port.
username string
Authentication username.
keyFiles IPrivateKeySource[]
Authentication private key file(s) .
keyFiles is null.
host is invalid.
-or-
username is null or contains only whitespace characters.
port is not within System.Net.IPEndPoint.MinPort and System.Net.IPEndPoint.MaxPort.
Initializes a new instance of the Renci.SshNet.SftpClient class.
public SftpClient(string host, string username, params IPrivateKeySource[] keyFiles)host string
Connection host.
username string
Authentication username.
keyFiles IPrivateKeySource[]
Authentication private key file(s) .
keyFiles is null.
host is invalid.
-or-
username is null or contains only whitespace characters.
Gets or sets the maximum size of the buffer in bytes.
public uint BufferSize { get; set; }For write operations, this limits the size of the payload for individual SSH_FXP_WRITE messages. The actual size is always capped at the maximum packet size supported by the peer (minus the size of protocol fields).
For read operations, this controls the size of the payload which is requested from the peer in a SSH_FXP_READ message. The peer will send the requested number of bytes in a SSH_FXP_DATA message, possibly split over multiple SSH_MSG_CHANNEL_DATA messages.
To optimize the size of the SSH packets sent by the peer, the actual requested size will take into account the size of the SSH_FXP_DATA protocol fields.
The size of the each individual SSH_FXP_DATA message is limited to the local maximum packet size of the channel, which is set to 64 KB for SSH.NET. However, the peer can limit this even further.
The method was called after the client was disposed.
Gets a value indicating whether this client is connected to the server and the SFTP session is open.
public override bool IsConnected { get; }The method was called after the client was disposed.
Gets or sets the operation timeout.
public TimeSpan OperationTimeout { get; set; }value represents a value that is less than -1 or greater than System.Int32.MaxValue milliseconds.
Gets sftp protocol version.
public int ProtocolVersion { get; }Client is not connected.
The method was called after the client was disposed.
Gets remote working directory.
public string WorkingDirectory { get; }Client is not connected.
The method was called after the client was disposed.
Appends lines to a file, creating the file if it does not already exist.
public void AppendAllLines(string path, IEnumerable<string> contents)path string
The file to append the lines to. The file is created if it does not already exist.
contents IEnumerable<string>
The lines to append to the file.
The characters are written to the file using UTF-8 encoding without a byte-order mark (BOM).
Exceptionspath is null.
-or-
contents is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Appends lines to a file by using a specified encoding, creating the file if it does not already exist.
public void AppendAllLines(string path, IEnumerable<string> contents, Encoding encoding)path string
The file to append the lines to. The file is created if it does not already exist.
contents IEnumerable<string>
The lines to append to the file.
encoding Encoding
The character encoding to use.
path is null.
-or-
contents is null.
-or-
encoding is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Appends the specified string to the file, creating the file if it does not already exist.
public void AppendAllText(string path, string contents)path string
The file to append the specified string to.
contents string
The string to append to the file.
The characters are written to the file using UTF-8 encoding without a Byte-Order Mark (BOM).
Exceptionspath is null.
-or-
contents is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Appends the specified string to the file, creating the file if it does not already exist.
public void AppendAllText(string path, string contents, Encoding encoding)path string
The file to append the specified string to.
contents string
The string to append to the file.
encoding Encoding
The character encoding to use.
path is null.
-or-
contents is null.
-or-
encoding is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Creates a System.IO.StreamWriter that appends UTF-8 encoded text to the specified file, creating the file if it does not already exist.
public StreamWriter AppendText(string path)path string
The path to the file to append to.
A System.IO.StreamWriter that appends text to a file using UTF-8 encoding without a Byte-Order Mark (BOM).
path is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Creates a System.IO.StreamWriter that appends text to a file using the specified encoding, creating the file if it does not already exist.
public StreamWriter AppendText(string path, Encoding encoding)path string
The path to the file to append to.
encoding Encoding
The character encoding to use.
A System.IO.StreamWriter that appends text to a file using the specified encoding.
path is null.
-or-
encoding is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Begins an asynchronous file downloading into the stream.
public IAsyncResult BeginDownloadFile(string path, Stream output)path string
The path.
output Stream
The output.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to output, may under certain conditions result in exceptions thrown by the stream.
output is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Begins an asynchronous file downloading into the stream.
public IAsyncResult BeginDownloadFile(string path, Stream output, AsyncCallback? asyncCallback)path string
The path.
output Stream
The output.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to output, may under certain conditions result in exceptions thrown by the stream.
output is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Begins an asynchronous file downloading into the stream.
public IAsyncResult BeginDownloadFile(string path, Stream output, AsyncCallback? asyncCallback, object? state, Action<ulong>? downloadCallback = null)path string
The path.
output Stream
The output.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
state object?
A user-provided object that distinguishes this particular asynchronous write request from other requests.
downloadCallback Action<ulong>?
The download callback.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to output, may under certain conditions result in exceptions thrown by the stream.
output is null.
path is null or contains only whitespace characters.
The method was called after the client was disposed.
Begins an asynchronous operation of retrieving list of files in remote directory.
public IAsyncResult BeginListDirectory(string path, AsyncCallback? asyncCallback, object? state, Action<int>? listCallback = null)path string
The path.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
state object?
A user-provided object that distinguishes this particular asynchronous write request from other requests.
listCallback Action<int>?
The list callback.
An System.IAsyncResult that references the asynchronous operation.
The method was called after the client was disposed.
Begins the synchronize directories.
public IAsyncResult BeginSynchronizeDirectories(string sourcePath, string destinationPath, string searchPattern, AsyncCallback? asyncCallback, object? state)sourcePath string
The source path.
destinationPath string
The destination path.
searchPattern string
The search pattern.
asyncCallback AsyncCallback?
The async callback.
state object?
The state.
An System.IAsyncResult that represents the asynchronous directory synchronization.
sourcePath or searchPattern is null.
destinationPath is null or contains only whitespace.
If a problem occurs while copying the file.
Begins an asynchronous uploading the stream into remote file.
public IAsyncResult BeginUploadFile(Stream input, string path)input Stream
Data input stream.
path string
Remote file path.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
If the remote file already exists, it is overwritten and truncated.
Exceptionsinput is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to list the contents of the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Begins an asynchronous uploading the stream into remote file.
public IAsyncResult BeginUploadFile(Stream input, string path, AsyncCallback? asyncCallback)input Stream
Data input stream.
path string
Remote file path.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
If the remote file already exists, it is overwritten and truncated.
Exceptionsinput is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to list the contents of the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Begins an asynchronous uploading the stream into remote file.
public IAsyncResult BeginUploadFile(Stream input, string path, AsyncCallback? asyncCallback, object? state, Action<ulong>? uploadCallback = null)input Stream
Data input stream.
path string
Remote file path.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
state object?
A user-provided object that distinguishes this particular asynchronous write request from other requests.
uploadCallback Action<ulong>?
The upload callback.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
If the remote file already exists, it is overwritten and truncated.
Exceptionsinput is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to list the contents of the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Begins an asynchronous uploading the stream into remote file.
public IAsyncResult BeginUploadFile(Stream input, string path, bool canOverride, AsyncCallback? asyncCallback, object? state, Action<ulong>? uploadCallback = null)input Stream
Data input stream.
path string
Remote file path.
canOverride bool
Specified whether an existing file can be overwritten.
asyncCallback AsyncCallback?
The method to be called when the asynchronous write operation is completed.
state object?
A user-provided object that distinguishes this particular asynchronous write request from other requests.
uploadCallback Action<ulong>?
The upload callback.
An System.IAsyncResult that references the asynchronous operation.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
When path refers to an existing file, set canOverride to true to overwrite and truncate that file. If canOverride is false, the upload will fail and Renci.SshNet.SftpClient.EndUploadFile(System.IAsyncResult) will throw an Renci.SshNet.Common.SshException.
input is null.
path is null or contains only whitespace characters.
The method was called after the client was disposed.
Changes remote directory to path.
public void ChangeDirectory(string path)path string
New directory path.
path is null.
Client is not connected.
Permission to change directory denied by remote host.
-or-
A SSH command was denied by the server.path was not found on the remote host.
A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously requests to change the current working directory to the specified path.
public Task ChangeDirectoryAsync(string path, CancellationToken cancellationToken = default)path string
The new working directory.
cancellationToken CancellationToken
The token to monitor for cancellation requests.
A System.Threading.Tasks.Task that tracks the asynchronous change working directory request.
path is null.
Client is not connected.
Permission to change directory denied by remote host.
-or-
A SSH command was denied by the server.path was not found on the remote host.
A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Changes permissions of file(s) to specified mode.
public void ChangePermissions(string path, short mode)path string
File(s) path, may match multiple files.
mode short
The mode.
path is null.
Client is not connected.
Permission to change permission on the path(s) was denied by the remote host.
-or-
A SSH command was denied by the server.path was not found on the remote host.
A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Creates or overwrites a file in the specified path.
public SftpFileStream Create(string path)path string
The path and name of the file to create.
A Renci.SshNet.Sftp.SftpFileStream that provides read/write access to the file specified in path.
If the target file already exists, it is first truncated to zero bytes.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Creates or overwrites the specified file.
public SftpFileStream Create(string path, int bufferSize)path string
The path and name of the file to create.
bufferSize int
The maximum number of bytes buffered for reads and writes to the file.
A Renci.SshNet.Sftp.SftpFileStream that provides read/write access to the file specified in path.
If the target file already exists, it is first truncated to zero bytes.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Creates remote directory specified by path.
public void CreateDirectory(string path)path string
Directory path to create.
path is null or contains only whitespace characters.
Client is not connected.
Permission to create the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously requests to create a remote directory specified by path.
public Task CreateDirectoryAsync(string path, CancellationToken cancellationToken = default)path string
Directory path to create.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task that represents the asynchronous create directory operation.
path is null or contains only whitespace characters.
Client is not connected.
Permission to create the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Creates or opens a file for writing UTF-8 encoded text.
public StreamWriter CreateText(string path)path string
The file to be opened for writing.
A System.IO.StreamWriter that writes text to a file using UTF-8 encoding without a Byte-Order Mark (BOM).
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Creates or opens a file for writing text using the specified encoding.
public StreamWriter CreateText(string path, Encoding encoding)path string
The file to be opened for writing.
encoding Encoding
The character encoding to use.
A System.IO.StreamWriter that writes to a file using the specified encoding.
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Deletes the specified file or directory.
public void Delete(string path)path string
The name of the file or directory to be deleted. Wildcard characters are not supported.
path is null.
Client is not connected.
path was not found on the remote host.
The method was called after the client was disposed.
Permanently deletes a file on remote machine.
public Task DeleteAsync(string path, CancellationToken cancellationToken = default)path string
The name of the file or directory to be deleted. Wildcard characters are not supported.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task that represents the asynchronous delete operation.
Deletes remote directory specified by path.
public void DeleteDirectory(string path)path string
Directory to be deleted path.
path is null or contains only whitespace characters.
Client is not connected.
path was not found on the remote host.
Permission to delete the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously deletes a remote directory.
public Task DeleteDirectoryAsync(string path, CancellationToken cancellationToken = default)path string
The path of the directory to be deleted.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task that represents the asynchronous delete operation.
path is null or contains only whitespace characters.
Client is not connected.
path was not found on the remote host.
Permission to delete the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Deletes remote file specified by path.
public void DeleteFile(string path)path string
File to be deleted path.
path is null or contains only whitespace characters.
Client is not connected.
path was not found on the remote host.
Permission to delete the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously deletes remote file specified by path.
public Task DeleteFileAsync(string path, CancellationToken cancellationToken)path string
File to be deleted path.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task that represents the asynchronous delete operation.
path is null or contains only whitespace characters.
Client is not connected.
path was not found on the remote host.
Permission to delete the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Releases unmanaged and - optionally - managed resources.
protected override void Dispose(bool disposing)disposing bool
true to release both managed and unmanaged resources; false to release only unmanaged resources.
Downloads remote file specified by the path into the stream.
public void DownloadFile(string path, Stream output, Action<ulong>? downloadCallback = null)path string
File to download.
output Stream
Stream to write the file into.
downloadCallback Action<ulong>?
The download callback.
Method calls made by this method to output, may under certain conditions result in exceptions thrown by the stream.
output is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.path was not found on the remote host.
A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Ends an asynchronous file downloading into the stream.
public void EndDownloadFile(IAsyncResult asyncResult)asyncResult IAsyncResult
The pending asynchronous SFTP request.
The System.IAsyncResult object did not come from the corresponding async method on this type.
-or-
Renci.SshNet.SftpClient.EndDownloadFile(System.IAsyncResult) was called multiple times with the same System.IAsyncResult.Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.The path was not found on the remote host.
A SSH error where System.Exception.Message is the message from the remote host.
Ends an asynchronous operation of retrieving list of files in remote directory.
public IEnumerable<ISftpFile> EndListDirectory(IAsyncResult asyncResult)asyncResult IAsyncResult
The pending asynchronous SFTP request.
A list of files.
The System.IAsyncResult object did not come from the corresponding async method on this type.
-or-
Renci.SshNet.SftpClient.EndListDirectory(System.IAsyncResult) was called multiple times with the same System.IAsyncResult.Ends the synchronize directories.
public IEnumerable<FileInfo> EndSynchronizeDirectories(IAsyncResult asyncResult)asyncResult IAsyncResult
The async result.
A list of uploaded files.
The System.IAsyncResult object did not come from the corresponding async method on this type.
-or-
Renci.SshNet.SftpClient.EndSynchronizeDirectories(System.IAsyncResult) was called multiple times with the same System.IAsyncResult.The destination path was not found on the remote host.
Ends an asynchronous uploading the stream into remote file.
public void EndUploadFile(IAsyncResult asyncResult)asyncResult IAsyncResult
The pending asynchronous SFTP request.
The System.IAsyncResult object did not come from the corresponding async method on this type.
-or-
Renci.SshNet.SftpClient.EndUploadFile(System.IAsyncResult) was called multiple times with the same System.IAsyncResult.Client is not connected.
The directory of the file was not found on the remote host.
Permission to upload the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
Checks whether file or directory exists.
public bool Exists(string path)path string
The path.
path is null or contains only whitespace characters.
Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Checks whether file or directory exists.
public Task<bool> ExistsAsync(string path, CancellationToken cancellationToken = default)path string
The path.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task`1 that represents the exists operation. The task result contains true if directory or file exists; otherwise false.
path is null or contains only whitespace characters.
Client is not connected.
Permission to perform the operation was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Gets reference to remote file or directory.
public ISftpFile Get(string path)path string
The path.
A reference to Renci.SshNet.Sftp.ISftpFile file object.
Client is not connected.
path was not found on the remote host.
path is null.
The method was called after the client was disposed.
Gets reference to remote file or directory.
public Task<ISftpFile> GetAsync(string path, CancellationToken cancellationToken)path string
The path.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task`1 that represents the get operation. The task result contains the reference to Renci.SshNet.Sftp.ISftpFile file object.
Client is not connected.
path was not found on the remote host.
path is null.
The method was called after the client was disposed.
Gets the Renci.SshNet.Sftp.SftpFileAttributes of the file on the path.
public SftpFileAttributes GetAttributes(string path)path string
The path to the file.
The Renci.SshNet.Sftp.SftpFileAttributes of the file on the path.
path is null.
Client is not connected.
path was not found on the remote host.
The method was called after the client was disposed.
Returns the date and time the specified file or directory was last accessed.
public DateTime GetLastAccessTime(string path)path string
The file or directory for which to obtain access date and time information.
A System.DateTime structure set to the date and time that the specified file or directory was last accessed. This value is expressed in local time.
path is null.
Client is not connected.
The method was called after the client was disposed.
Returns the date and time, in coordinated universal time (UTC), that the specified file or directory was last accessed.
public DateTime GetLastAccessTimeUtc(string path)path string
The file or directory for which to obtain access date and time information.
A System.DateTime structure set to the date and time that the specified file or directory was last accessed. This value is expressed in UTC time.
path is null.
Client is not connected.
The method was called after the client was disposed.
Returns the date and time the specified file or directory was last written to.
public DateTime GetLastWriteTime(string path)path string
The file or directory for which to obtain write date and time information.
A System.DateTime structure set to the date and time that the specified file or directory was last written to. This value is expressed in local time.
path is null.
Client is not connected.
The method was called after the client was disposed.
Returns the date and time, in coordinated universal time (UTC), that the specified file or directory was last written to.
public DateTime GetLastWriteTimeUtc(string path)path string
The file or directory for which to obtain write date and time information.
A System.DateTime structure set to the date and time that the specified file or directory was last written to. This value is expressed in UTC time.
path is null.
Client is not connected.
The method was called after the client was disposed.
Gets status using statvfs@openssh.com request.
public SftpFileSystemInformation GetStatus(string path)path string
The path.
A Renci.SshNet.Sftp.SftpFileSystemInformation instance that contains file status information.
Client is not connected.
path is null.
The method was called after the client was disposed.
Asynchronously gets status using statvfs@openssh.com request.
public Task<SftpFileSystemInformation> GetStatusAsync(string path, CancellationToken cancellationToken)path string
The path.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task`1 that represents the status operation. The task result contains the Renci.SshNet.Sftp.SftpFileSystemInformation instance that contains file status information.
Client is not connected.
path is null.
The method was called after the client was disposed.
Retrieves list of files in remote directory.
public IEnumerable<ISftpFile> ListDirectory(string path, Action<int>? listCallback = null)path string
The path.
listCallback Action<int>?
The list callback.
A list of files.
path is null.
Client is not connected.
Permission to list the contents of the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously enumerates the files in remote directory.
public IAsyncEnumerable<ISftpFile> ListDirectoryAsync(string path, CancellationToken cancellationToken)path string
The path.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
An System.Collections.Generic.IAsyncEnumerable`1 of Renci.SshNet.Sftp.ISftpFile that represents the asynchronous enumeration operation. The enumeration contains an async stream of Renci.SshNet.Sftp.ISftpFile for the files in the directory specified by path.
path is null.
Client is not connected.
Permission to list the contents of the directory was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Called when client is connected to the server.
protected override void OnConnected()Called when client is disconnecting from the server.
protected override void OnDisconnecting()Opens a Renci.SshNet.Sftp.SftpFileStream on the specified path with read/write access.
public SftpFileStream Open(string path, FileMode mode)path string
The file to open.
mode FileMode
A System.IO.FileMode value that specifies whether a file is created if one does not exist, and determines whether the contents of existing files are retained or overwritten.
An unshared Renci.SshNet.Sftp.SftpFileStream that provides access to the specified file, with the specified mode and read/write access.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a Renci.SshNet.Sftp.SftpFileStream on the specified path, with the specified mode and access.
public SftpFileStream Open(string path, FileMode mode, FileAccess access)path string
The file to open.
mode FileMode
A System.IO.FileMode value that specifies whether a file is created if one does not exist, and determines whether the contents of existing files are retained or overwritten.
access FileAccess
A System.IO.FileAccess value that specifies the operations that can be performed on the file.
An unshared Renci.SshNet.Sftp.SftpFileStream that provides access to the specified file, with the specified mode and access.
path is null.
Client is not connected.
The method was called after the client was disposed.
Asynchronously opens a Renci.SshNet.Sftp.SftpFileStream on the specified path, with the specified mode and access.
public Task<SftpFileStream> OpenAsync(string path, FileMode mode, FileAccess access, CancellationToken cancellationToken)path string
The file to open.
mode FileMode
A System.IO.FileMode value that specifies whether a file is created if one does not exist, and determines whether the contents of existing files are retained or overwritten.
access FileAccess
A System.IO.FileAccess value that specifies the operations that can be performed on the file.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task`1 that represents the asynchronous open operation. The task result contains the Renci.SshNet.Sftp.SftpFileStream that provides access to the specified file, with the specified mode and access.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens an existing file for reading.
public SftpFileStream OpenRead(string path)path string
The file to be opened for reading.
A read-only Renci.SshNet.Sftp.SftpFileStream on the specified path.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens an existing UTF-8 encoded text file for reading.
public StreamReader OpenText(string path)path string
The file to be opened for reading.
A System.IO.StreamReader on the specified path.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a file for writing.
public SftpFileStream OpenWrite(string path)path string
The file to be opened for writing.
An unshared Renci.SshNet.Sftp.SftpFileStream object on the specified path with System.IO.FileAccess.Write access.
If the file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The method was called after the client was disposed.
Opens a binary file, reads the contents of the file into a byte array, and closes the file.
public byte[] ReadAllBytes(string path)path string
The file to open for reading.
A byte array containing the contents of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a text file, reads all lines of the file using UTF-8 encoding, and closes the file.
public string[] ReadAllLines(string path)path string
The file to open for reading.
A string array containing all lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a file, reads all lines of the file with the specified encoding, and closes the file.
public string[] ReadAllLines(string path, Encoding encoding)path string
The file to open for reading.
encoding Encoding
The encoding applied to the contents of the file.
A string array containing all lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a text file, reads all lines of the file with the UTF-8 encoding, and closes the file.
public string ReadAllText(string path)path string
The file to open for reading.
A string containing all lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Opens a file, reads all lines of the file with the specified encoding, and closes the file.
public string ReadAllText(string path, Encoding encoding)path string
The file to open for reading.
encoding Encoding
The encoding applied to the contents of the file.
A string containing all lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Reads the lines of a file with the UTF-8 encoding.
public IEnumerable<string> ReadLines(string path)path string
The file to read.
The lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Read the lines of a file that has a specified encoding.
public IEnumerable<string> ReadLines(string path, Encoding encoding)path string
The file to read.
encoding Encoding
The encoding that is applied to the contents of the file.
The lines of the file.
path is null.
Client is not connected.
The method was called after the client was disposed.
Renames remote file from old path to new path.
public void RenameFile(string oldPath, string newPath)oldPath string
Path to the old file location.
newPath string
Path to the new file location.
oldPath is null.
-or-
ornewPath is null.
Client is not connected.
Permission to rename the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Renames remote file from old path to new path.
public void RenameFile(string oldPath, string newPath, bool isPosix)oldPath string
Path to the old file location.
newPath string
Path to the new file location.
isPosix bool
if set to true then perform a posix rename.
oldPath is null.
-or-
ornewPath is null.
Client is not connected.
Permission to rename the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Asynchronously renames remote file from old path to new path.
public Task RenameFileAsync(string oldPath, string newPath, CancellationToken cancellationToken)oldPath string
Path to the old file location.
newPath string
Path to the new file location.
cancellationToken CancellationToken
The System.Threading.CancellationToken to observe.
A System.Threading.Tasks.Task that represents the asynchronous rename operation.
oldPath is null.
-or-
ornewPath is null.
Client is not connected.
Permission to rename the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Sets the specified Renci.SshNet.Sftp.SftpFileAttributes of the file on the specified path.
public void SetAttributes(string path, SftpFileAttributes fileAttributes)path string
The path to the file.
fileAttributes SftpFileAttributes
The desired Renci.SshNet.Sftp.SftpFileAttributes.
path is null.
Client is not connected.
The method was called after the client was disposed.
Sets the date and time the specified file was last accessed.
public void SetLastAccessTime(string path, DateTime lastAccessTime)path string
The file for which to set the access date and time information.
lastAccessTime DateTime
A System.DateTime containing the value to set for the last access date and time of path. This value is expressed in local time.
Sets the date and time, in coordinated universal time (UTC), that the specified file was last accessed.
public void SetLastAccessTimeUtc(string path, DateTime lastAccessTimeUtc)path string
The file for which to set the access date and time information.
lastAccessTimeUtc DateTime
A System.DateTime containing the value to set for the last access date and time of path. This value is expressed in UTC time.
Sets the date and time that the specified file was last written to.
public void SetLastWriteTime(string path, DateTime lastWriteTime)path string
The file for which to set the date and time information.
lastWriteTime DateTime
A System.DateTime containing the value to set for the last write date and time of path. This value is expressed in local time.
Sets the date and time, in coordinated universal time (UTC), that the specified file was last written to.
public void SetLastWriteTimeUtc(string path, DateTime lastWriteTimeUtc)path string
The file for which to set the date and time information.
lastWriteTimeUtc DateTime
A System.DateTime containing the value to set for the last write date and time of path. This value is expressed in UTC time.
Creates a symbolic link from old path to new path.
public void SymbolicLink(string path, string linkPath)path string
The old path.
linkPath string
The new path.
path is null.
-or-
linkPath is null or contains only whitespace characters.
Client is not connected.
Permission to create the symbolic link was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Synchronizes the directories.
public IEnumerable<FileInfo> SynchronizeDirectories(string sourcePath, string destinationPath, string searchPattern)sourcePath string
The source path.
destinationPath string
The destination path.
searchPattern string
The search pattern.
A list of uploaded files.
sourcePath is null.
destinationPath is null or contains only whitespace.
destinationPath was not found on the remote host.
If a problem occurs while copying the file.
Uploads stream into remote file.
public void UploadFile(Stream input, string path, Action<ulong>? uploadCallback = null)input Stream
Data input stream.
path string
Remote file path.
uploadCallback Action<ulong>?
The upload callback.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
input is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to upload the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Uploads stream into remote file.
public void UploadFile(Stream input, string path, bool canOverride, Action<ulong>? uploadCallback = null)input Stream
Data input stream.
path string
Remote file path.
canOverride bool
if set to true then existing file will be overwritten.
uploadCallback Action<ulong>?
The upload callback.
Method calls made by this method to input, may under certain conditions result in exceptions thrown by the stream.
input is null.
path is null or contains only whitespace characters.
Client is not connected.
Permission to upload the file was denied by the remote host.
-or-
A SSH command was denied by the server.A SSH error where System.Exception.Message is the message from the remote host.
The method was called after the client was disposed.
Writes the specified byte array to the specified file, and closes the file.
public void WriteAllBytes(string path, byte[] bytes)path string
The file to write to.
bytes byte[]
The bytes to write to the file.
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Writes a collection of strings to the file using the UTF-8 encoding, and closes the file.
public void WriteAllLines(string path, IEnumerable<string> contents)path string
The file to write to.
contents IEnumerable<string>
The lines to write to the file.
The characters are written to the file using UTF-8 encoding without a Byte-Order Mark (BOM).
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Write the specified string array to the file using the UTF-8 encoding, and closes the file.
public void WriteAllLines(string path, string[] contents)path string
The file to write to.
contents string[]
The string array to write to the file.
The characters are written to the file using UTF-8 encoding without a Byte-Order Mark (BOM).
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Writes a collection of strings to the file using the specified encoding, and closes the file.
public void WriteAllLines(string path, IEnumerable<string> contents, Encoding encoding)path string
The file to write to.
contents IEnumerable<string>
The lines to write to the file.
encoding Encoding
The character encoding to use.
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Writes the specified string array to the file by using the specified encoding, and closes the file.
public void WriteAllLines(string path, string[] contents, Encoding encoding)path string
The file to write to.
contents string[]
The string array to write to the file.
encoding Encoding
An System.Text.Encoding object that represents the character encoding applied to the string array.
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Writes the specified string to the file using the UTF-8 encoding, and closes the file.
public void WriteAllText(string path, string contents)path string
The file to write to.
contents string
The string to write to the file.
The characters are written to the file using UTF-8 encoding without a Byte-Order Mark (BOM).
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
Writes the specified string to the file using the specified encoding, and closes the file.
public void WriteAllText(string path, string contents, Encoding encoding)path string
The file to write to.
contents string
The string to write to the file.
encoding Encoding
The encoding to apply to the string.
If the target file already exists, it is overwritten. It is not first truncated to zero bytes.
If the target file does not exist, it is created.
Exceptionspath is null.
Client is not connected.
The specified path is invalid, or its directory was not found on the remote host.
The method was called after the client was disposed.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4