CloudTable.CreateIfNotExistsAsync Method

Reference

Definition

Namespace:: Microsoft.Azure.Cosmos.Table

Assembly:: Microsoft.Azure.Cosmos.Table.dll

Assembly:: Microsoft.Azure.Cosmos.Table.Client.dll

Package:: Microsoft.Azure.Cosmos.Table v1.0.8

Package:: Microsoft.Azure.Cosmos.Table v2.0.0-preview

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.

Overloads

CreateIfNotExistsAsync()	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(CancellationToken)	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(TableRequestOptions, OperationContext)	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)	Initiates an asynchronous operation to create a table if it does not already exist.
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)	Initiates an asynchronous operation to create a table if it does not already exist.

CreateIfNotExistsAsync()

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync ();

abstract member CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync () As Task(Of Boolean)

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext) As Task(Of Boolean)

Parameters

requestOptions: TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

indexingMode: IndexingMode

CosmosDB table indexing mode

throughput: Nullable<Int32>

CosmosDB table throughput

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions: TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

indexingMode: IndexingMode

CosmosDB table indexing mode

throughput: Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive: Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, Microsoft.Azure.Cosmos.IndexingMode? indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, indexingMode As Nullable(Of IndexingMode), throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions: TableRequestOptions

operationContext: OperationContext

indexingMode: Nullable<IndexingMode>

throughput: Nullable<Int32>

cancellationToken: CancellationToken

Returns

Task<Boolean>

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Initiates an asynchronous operation to create a table if it does not already exist.

public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, string serializedIndexingPolicy, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);

abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, serializedIndexingPolicy As String, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

requestOptions: TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

serializedIndexingPolicy: String

CosmosDB table indexing policy.

throughput: Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive: Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object of type bool that represents the asynchronous operation.

Remarks

This API performs an existence check and therefore requires list permissions.

Applies to

Share via

CloudTable.CreateIfNotExistsAsync Method

Definition

Overloads

CreateIfNotExistsAsync()

Returns

Remarks

Applies to

CreateIfNotExistsAsync(CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)

Parameters

Returns

Applies to

CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)

Parameters

Returns

Remarks

Applies to

Additional resources