(C# UWP/WinRT) SFTP Read Text File to String

Demonstrates how to download a text file from an SSH server directly into a string variable.

Chilkat Universal Windows Platform (UWP) / WinRT Downloads Chilkat for the Universal Windows Platform (UWP)

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

Chilkat.SFtp sftp = new Chilkat.SFtp();

// Set some timeouts, in milliseconds:
sftp.ConnectTimeoutMs = 5000;
sftp.IdleTimeoutMs = 15000;

// Connect to the SSH server.  
// The standard SSH port = 22
// The hostname may be a hostname or IP address.
string hostname = "sftp.example.com";
int port = 22;
bool success = await sftp.ConnectAsync(hostname,port);
if (success != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

// Authenticate with the SSH server.  Chilkat SFTP supports
// both password-based authenication as well as public-key
// authentication.  This example uses password authenication.
success = await sftp.AuthenticatePwAsync("myLogin","myPassword");
if (success != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

// After authenticating, the SFTP subsystem must be initialized:
success = await sftp.InitializeSftpAsync();
if (success != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

// Open a file on the server:
string handle;
handle = await sftp.OpenFileAsync("hamlet.xml","readOnly","openExisting");
if (sftp.LastMethodSuccess != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

// Get the total size of this file (in bytes)
bool bFollowLinks = false;
bool bIsHandle = true;
int numBytes;

// bFollowLinks is ignored because we are passing a handle
// and not a remote filename.
// There are alternative methods for handling file sizes
// greater than 32-bit.  (See the reference documentation.)
numBytes = await sftp.GetFileSize32Async(handle,bFollowLinks,bIsHandle);
if (numBytes < 0) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

// The charset indicates the character encoding of the text
// file on the SSH server.   Setting the charset correctly
// allows the Chilkat SFTP component to correctly interpret
// the bytes that represent the characters.
string charset;
charset = "ansi";
string fileContents;
fileContents = await sftp.ReadFileTextAsync(handle,numBytes,charset);
if (sftp.LastMethodSuccess != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}
else {
    Debug.WriteLine("Received file:");
    Debug.WriteLine(fileContents);
}

// Close the file.
success = await sftp.CloseHandleAsync(handle);
if (success != true) {
    Debug.WriteLine(sftp.LastErrorText);
    return;
}

Debug.WriteLine("Success.");