Merge "[Tizen.WebView] Fix document build warnings"
[platform/core/csapi/tizenfx.git] / src / Tizen.Pims.Calendar / Tizen.Pims.Calendar / CalendarQuery.cs
index 5ddf149..050e7a8 100644 (file)
@@ -22,6 +22,7 @@ namespace Tizen.Pims.Calendar
     /// <summary>
     /// A query is used to retrieve data which satisfies given criteria.
     /// </summary>
+    /// <since_tizen> 4 </since_tizen>
     /// <remarks>
     /// A query is used to retrieve calendar data which satisfies a given criteria,
     /// such as an integer property being greater than a given value,
@@ -35,8 +36,10 @@ namespace Tizen.Pims.Calendar
         /// <summary>
         /// Creates a query.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
+        /// <feature>http://tizen.org/feature/calendar</feature>
         /// <param name="viewUri">The view URI of a query</param>
-        /// <exception cref="NotSupportedException">Thrown when an invoked method is not supported</exception>
+        /// <exception cref="NotSupportedException">Thrown when feature is not supported</exception>
         /// <exception cref="ArgumentException">Thrown when one of the arguments provided to a method is not valid</exception>
         /// <exception cref="OutOfMemoryException">Thrown when failed due to out of memory</exception>
         [SuppressMessage("Microsoft.Design", "CA1054:UriParametersShouldNotBeStrings")]
@@ -80,7 +83,6 @@ namespace Tizen.Pims.Calendar
                 if (CalendarError.None != (CalendarError)error)
                 {
                     Log.Error(Globals.LogTag, "CalendarQueryDestroy Failed with error " + error);
-                    throw CalendarErrorFactory.GetException(error);
                 }
                 disposedValue = true;
             }
@@ -100,10 +102,18 @@ namespace Tizen.Pims.Calendar
         /// <summary>
         /// Adds property IDs for projection.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         /// <param name="propertyIdArray">The property ID array </param>
+        /// <feature>http://tizen.org/feature/calendar</feature>
+        /// <exception cref="NotSupportedException">Thrown when feature is not supported</exception>
         /// <exception cref="ArgumentException">Thrown when one of the arguments provided to a method is not valid</exception>
         public void SetProjection(uint[] propertyIdArray)
         {
+            if (propertyIdArray == null)
+            {
+                throw new ArgumentException("Invalid Parameters Provided");
+            }
+
             int error = Interop.Query.SetProjection(_queryHandle, propertyIdArray, propertyIdArray.Length);
             if (CalendarError.None != (CalendarError)error)
             {
@@ -115,7 +125,10 @@ namespace Tizen.Pims.Calendar
         /// <summary>
         /// Sets the "distinct" option for projection.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         /// <param name="set">If true it is set, otherwise if false it is unset</param>
+        /// <feature>http://tizen.org/feature/calendar</feature>
+        /// <exception cref="NotSupportedException">Thrown when feature is not supported</exception>
         /// <exception cref="ArgumentException">Thrown when one of the arguments provided to a method is not valid</exception>
         public void SetDistinct(bool set)
         {
@@ -130,7 +143,10 @@ namespace Tizen.Pims.Calendar
         /// <summary>
         /// Sets the filter for a query.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         /// <param name="filter">The filter</param>
+        /// <feature>http://tizen.org/feature/calendar</feature>
+        /// <exception cref="NotSupportedException">Thrown when feature is not supported</exception>
         /// <exception cref="ArgumentException">Thrown when one of the arguments provided to a method is not valid</exception>
         public void SetFilter(CalendarFilter filter)
         {
@@ -145,8 +161,11 @@ namespace Tizen.Pims.Calendar
         /// <summary>
         /// Sets the sort mode for a query.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         /// <param name="propertyId">The property ID to sort</param>
         /// <param name="isAscending">If true it sorts in the ascending order, otherwise if false it sorts in the descending order</param>
+        /// <feature>http://tizen.org/feature/calendar</feature>
+        /// <exception cref="NotSupportedException">Thrown when feature is not supported</exception>
         /// <exception cref="ArgumentException">Thrown when one of the arguments provided to a method is not valid</exception>
         public void SetSort(uint propertyId, bool isAscending)
         {