The Get() methods allow for direct access to a given key/value pair.

The generic form of the Get method allows for retrieval without the need to cast. If the stored type cannot be serialized to the generic type provided, an InvalidCastException will be thrown.

var beer = client.Get<Beer>("beer");

Calling the Get() method with a key and a new expiration value will cause get and touch operations to be performed.

var val = client.Get("beer", DateTime.Now.AddMinutes(5));

Calling Get() with multiple keys returns a dictionary with the associated values.

client.Store(StoreMode.Set, "brewer", "Cottrell Brewing Co.");
client.Store(StoreMode.Set, "beer", "Old Yankee Ale");

var dict = client.Get(new string[] { "brewery", "beer" });
Console.WriteLine(dict["brewery"]);
Console.WriteLine(dict["beer"]);

GetWithCas returns a CasResult, which includes the document and its CAS value.

For example:

var casResult = client.GetWithCas("beer");
client.Store(StoreMode.Set, "beer", "some other beer", casResult.Cas)

Calling GetWithCas() with multiple keys returns a dictionary with the associated values. The generic version will return the Result as an instance of T.

var casResult = client.GetWithCas<Beer>("beer");
Console.WriteLine(casResult.Name);

The ExecuteGet and generic ExecuteGet<T> methods are used to return detailed results in an instance of an IGetOperationResult.

var result = client.ExecuteGet("beer");

if (! result.Success)
{
    Console.WriteLine("Get failed with message {0} and status code {1}", result.Message, result.StatusCode);
    
    if (result.Exception != null)
    {
        throw result.Exception;
    }
}

var beer = result.Value as Beer;
beer.Brewery = "Cambridge Brewing Company";
var casResult = client.ExecuteCas(StoreMode.Set, "beer", beer, result.Cas); //ExecuteGet returns the CAS for the key

The generic form of ExecuteGet<T> will set the Value property to type T

var result = client.ExecuteGet<Beer>("beer");
var beer = result.Value; //no need to cast beer as a Beer

Calling the ExecuteGet() method with a key and a new expiration value will cause get and touch operations to be performed.

var val = client.Get("beer", DateTime.Now.AddMinutes(5));

Calling ExecuteGet() with multiple keys returns a dictionary with the associated IGetOperationResult values.

client.Store(StoreMode.Set, "brewery", "Cottrell Brewing Co.");
client.Store(StoreMode.Set, "beer", "Old Yankee Ale");

var dict = client.ExecuteGet(new string[] { "brewery", "beer" });
foreach(var key in dict.Keys)
{
    Console.WriteLine(dict[key]);
}

GetWithLock() prevents a key from being updated for either 30 seconds (default) or the value specified as an optional lock expiration.

var casResult = client.GetWithLock("beer", TimeSpan.FromSeconds(10));
var result = client.Store(StoreMode.Set, "beer", new Beer()); //result will be false

ExecuteGetWithLock() provides similar behavior to GetWithLock, but returns an IGetOperationResult, which allows for status codes to be checked.

var lockResult = client.ExecuteGetWithLock("key", TimeSpan.FromSeconds(30));
var storeResult = client.ExecuteStore(StoreMode.Set, "key", "new value");
//storeResult.Success will be false
//storeResult.StatusCode will be equal to (int)StatusCodeEnums.DataExistsForKey

var getLockResultA = client.ExecuteGetWithLock("key");
var getLockResultB = client.ExecuteGetWithLock("key");
//getLockResultB.StatusCode will be equalt to (int)CouchbaseStatusCodeEnums.LockError)

KeyExists() checks whether a key has been either a) written to RAM or b) written to disk on the master node for a key. If the key exists, the value is not returned.

var result = client.KeyExists("foo"); //result is true when "foo" exists