SimpleCursorAdapter Class

Reference

Definition

Namespace:: Android.Widget

Assembly:: Mono.Android.dll

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.

An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.

[Android.Runtime.Register("android/widget/SimpleCursorAdapter", DoNotGenerateAcw=true)]
public class SimpleCursorAdapter : Android.Widget.ResourceCursorAdapter

[<Android.Runtime.Register("android/widget/SimpleCursorAdapter", DoNotGenerateAcw=true)>]
type SimpleCursorAdapter = class
    inherit ResourceCursorAdapter

Inheritance: Object

Object

BaseAdapter

CursorAdapter

ResourceCursorAdapter
SimpleCursorAdapter

Attributes: RegisterAttribute

Remarks

An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file. You can specify which columns you want, which views you want to display the columns, and the XML file that defines the appearance of these views.

Binding occurs in two phases. First, if a android.widget.SimpleCursorAdapter.ViewBinder is available, ViewBinder#setViewValue(android.view.View, android.database.Cursor, int) is invoked. If the returned value is true, binding has occured. If the returned value is false and the view to bind is a TextView, #setViewText(TextView, String) is invoked. If the returned value is false and the view to bind is an ImageView, #setViewImage(ImageView, String) is invoked. If no appropriate binding can be found, an IllegalStateException is thrown.

If this adapter is used with filtering, for instance in an android.widget.AutoCompleteTextView, you can use the android.widget.SimpleCursorAdapter.CursorToStringConverter and the android.widget.FilterQueryProvider interfaces to get control over the filtering process. You can refer to #convertToString(android.database.Cursor) and #runQueryOnBackgroundThread(CharSequence) for more information.

Java documentation for android.widget.SimpleCursorAdapter.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

SimpleCursorAdapter(Context, Int32, ICursor, String[], Int32[], CursorAdapterFlags)	Standard constructor.
SimpleCursorAdapter(Context, Int32, ICursor, String[], Int32[])	Obsolete. Constructor the enables auto-requery.
SimpleCursorAdapter(IntPtr, JniHandleOwnership)	A constructor used when creating managed representations of JNI objects; called by the runtime.

Properties

Class	Returns the runtime class of this `Object`. (Inherited from Object)
Count	How many items are in the data set represented by this Adapter. (Inherited from CursorAdapter)
Cursor	Returns the cursor. (Inherited from CursorAdapter)
CursorToStringConverter	Returns the converter used to convert the filtering Cursor into a String. -or- Sets the converter used to convert the filtering Cursor into a String.
DropDownViewTheme	Sets the `Resources.Theme` against which drop-down views are inflated. (Inherited from CursorAdapter)
Filter	(Inherited from CursorAdapter)
FilterQueryProvider	Returns the query filter provider used for filtering. -or- Sets the query filter provider used to filter the current Cursor. (Inherited from CursorAdapter)
Handle	The handle to the underlying Android instance. (Inherited from Object)
HasStableIds	Indicates whether the item ids are stable across changes to the underlying data. (Inherited from BaseAdapter)
IsEmpty	(Inherited from BaseAdapter)
JniIdentityHashCode	(Inherited from Object)
JniPeerMembers
PeerReference	(Inherited from Object)
StringConversionColumn	Return the index of the column used to get a String representation of the Cursor. -or- Defines the index of the column in the Cursor used to get a String representation of that Cursor.
ThresholdClass	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.
ThresholdType	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.
ViewBinder	Returns the `ViewBinder` used to bind data to views. -or- Sets the binder used to bind data to views.
ViewTypeCount	(Inherited from BaseAdapter)

Methods

AreAllItemsEnabled()	Indicates whether all the items in this adapter are enabled. (Inherited from BaseAdapter)
BindView(View, Context, ICursor)	Binds all of the field names passed into the "to" parameter of the constructor with their corresponding cursor columns as specified in the "from" parameter.
ChangeCursor(ICursor)	Change the underlying cursor to a new cursor. (Inherited from CursorAdapter)
ChangeCursorAndColumns(ICursor, String[], Int32[])	Change the cursor and change the column-to-view mappings at the same time.
Clone()	Creates and returns a copy of this object. (Inherited from Object)
ConvertToString(ICursor)	Converts the cursor into a CharSequence. (Inherited from CursorAdapter)
ConvertToStringFormatted(ICursor)	Converts the cursor into a CharSequence. (Inherited from CursorAdapter)
Dispose()	(Inherited from Object)
Dispose(Boolean)	(Inherited from Object)
Equals(Object)	Indicates whether some other object is "equal to" this one. (Inherited from Object)
GetAutofillOptions()	(Inherited from BaseAdapter)
GetAutofillOptionsFormatted()	(Inherited from BaseAdapter)
GetDropDownView(Int32, View, ViewGroup)	Gets a View that displays in the drop down popup the data at the specified position in the data set. (Inherited from BaseAdapter)
GetHashCode()	Returns a hash code value for the object. (Inherited from Object)
GetItem(Int32)	Get the data item associated with the specified position in the data set. (Inherited from CursorAdapter)
GetItemId(Int32)	Get the row id associated with the specified position in the list. (Inherited from CursorAdapter)
GetItemViewType(Int32)	Get the type of View that will be created by View for the specified item. (Inherited from BaseAdapter)
GetView(Int32, View, ViewGroup)	Get a View that displays the data at the specified position in the data set. (Inherited from CursorAdapter)
Init(Context, ICursor, Boolean)	Obsolete. This member is deprecated. (Inherited from CursorAdapter)
IsEnabled(Int32)	Returns true if the item at the specified position is not a separator. (Inherited from BaseAdapter)
JavaFinalize()	Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object)
NewDropDownView(Context, ICursor, ViewGroup)	Makes a new drop down view to hold the data pointed to by cursor. (Inherited from CursorAdapter)
NewView(Context, ICursor, ViewGroup)	Inflates view(s) from the specified XML file. (Inherited from ResourceCursorAdapter)
Notify()	Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object)
NotifyAll()	Wakes up all threads that are waiting on this object's monitor. (Inherited from Object)
NotifyDataSetChanged()	Notifies the attached observers that the underlying data has been changed and any View reflecting the data set should refresh itself. (Inherited from BaseAdapter)
NotifyDataSetInvalidated()	Notifies the attached observers that the underlying data is no longer valid or available. (Inherited from BaseAdapter)
OnContentChanged()	Called when the `ContentObserver` on the cursor receives a change notification. (Inherited from CursorAdapter)
RegisterDataSetObserver(DataSetObserver)	Register an observer that is called when changes happen to the data used by this adapter. (Inherited from BaseAdapter)
RunQueryOnBackgroundThread(ICharSequence)	Runs a query with the specified constraint. (Inherited from CursorAdapter)
RunQueryOnBackgroundThread(String)	Runs a query with the specified constraint. (Inherited from CursorAdapter)
SetAutofillOptions(ICharSequence[])	Sets the value returned by `#getAutofillOptions()` (Inherited from BaseAdapter)
SetAutofillOptions(String[])	Sets the value returned by `#getAutofillOptions()` (Inherited from BaseAdapter)
SetDropDownViewResource(Int32)	Sets the layout resource of the drop down views. (Inherited from ResourceCursorAdapter)
SetHandle(IntPtr, JniHandleOwnership)	Sets the Handle property. (Inherited from Object)
SetViewImage(ImageView, String)	Called by bindView() to set the image for an ImageView but only if there is no existing ViewBinder or if the existing ViewBinder cannot handle binding to an ImageView.
SetViewResource(Int32)	Sets the layout resource of the item views. (Inherited from ResourceCursorAdapter)
SetViewText(TextView, String)	Called by bindView() to set the text for a TextView but only if there is no existing ViewBinder or if the existing ViewBinder cannot handle binding to a TextView.
SwapCursor(ICursor)	Swap in a new Cursor, returning the old Cursor. (Inherited from CursorAdapter)
ToArray<T>()	(Inherited from Object)
ToString()	Returns a string representation of the object. (Inherited from Object)
UnregisterDataSetObserver(DataSetObserver)	Unregister an observer that has previously been registered with this adapter via Android.Widget.Adapter.registerDataSetObserver(android.database.DataSetObserver). (Inherited from BaseAdapter)
UnregisterFromRuntime()	(Inherited from Object)
Wait()	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object)
Wait(Int64, Int32)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)
Wait(Int64)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed()	(Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced()	(Inherited from Object)
IJavaPeerable.Finalized()	(Inherited from Object)
IJavaPeerable.JniManagedPeerState	(Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	(Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	(Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	(Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
GetAutofillOptions(IAdapter)
JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to

Share via